AI 视频生成 API

VisionStory AI 视频生成 API 通过 Seedance、Wan 和 Kling 模型生成文生视频、图生视频和参考素材驱动的视频。使用同一个 API Key 即可查询模型、估算点数、提交任务、复用素材、轮询状态和下载结果。

Beta。 只要账户拥有有效的 Pro 或更高等级订阅，其 API Key 即可调用这些接口，无需额外申请能力白名单。

AI 视频接口

生成 AI 视频

提交文生视频任务，然后轮询至完成：

curl -s -H "X-API-Key: $VISIONSTORY_API_KEY" -H "Content-Type: application/json" -d '{"model_id": "seedance-2.0", "prompt": "A corgi surfing at sunset, cinematic lighting", "duration_sec": 8, "aspect_ratio": "9:16", "resolution": "1080p"}' https://openapi.visionstory.ai/api/v1/ai_video

{
  "data": {
    "video_id": "YOUR_AI_VIDEO_ID",
    "status": "queued",
    "cost_credit": 64
  }
}

每 5–10 秒轮询一次：

curl -s -H "X-API-Key: $VISIONSTORY_API_KEY" "https://openapi.visionstory.ai/api/v1/ai_video?video_id=YOUR_AI_VIDEO_ID"

AI 视频模型与能力

GET /api/v1/ai_video/models 返回各参数允许值、默认值和媒体限制。接入时应始终以该接口返回值为准：新增模型和参数值会在此出现，无需更改 API。

请从模型查询结果中读取各模型支持的画面比例、默认值和参考素材限制。Wan 支持 adaptive，提示词最多 20000 字符；其他模型最多 2500 字符。除 Kling 3.0 Omni 默认 1080p 外，其余模型默认 720p。Seedance 2.5 默认 15 秒，其他 Seedance 模型默认 5 秒。原生音频默认开启。

480p 仅适用于 Seedance 和 Wan 的 AI 视频。 Kling 和新的数字人视频请求不支持 480p；历史数字人视频响应仍可能包含 480p。

估算 AI 视频点数成本

生成任务按点数计费，提交时扣除，生成失败会自动全额退还。成本取决于模型、分辨率和时长，按秒计算。提交前调用成本接口，它与实际计费使用完全相同的公式：

curl -s -H "X-API-Key: $VISIONSTORY_API_KEY" "https://openapi.visionstory.ai/api/v1/ai_video/cost?model_id=seedance-2.0&duration_sec=8&resolution=1080p"

{
  "data": {
    "credit": 64
  }
}

参考素材和 generate_audio 不改变点数价格。当前每秒费率如下：

请通过成本接口查询当前报价，不要长期缓存此表。剩余点数可通过 GET /api/v1/billing/credits 查询。

图片、视频与音频输入

每个媒体位置（first_frame、end_frame、refs[]）都必须从以下三种形式中选择且仅选择一种：

以下媒体限制针对 Seedance 输入。Wan 和 Kling 有各自的模型限制，上传前请读取能力表。

配置 AI 视频请求

POST /api/v1/ai_video 在同一接口中支持两种模式：传入 first_frame（可选 end_frame）进行图生视频；传入 refs 进行参考素材驱动的文生视频，可用于角色一致性、风格、动作或声音参考；两者都不传则是纯文生视频。refs 与 first_frame 互斥。未知字段和不支持的值会被拒绝，不会静默忽略。

各模型的输入组合

• Wan：最多 10 个图片、5 个视频和 5 个音频参考，同时受模型查询返回的总数上限约束。视频和音频参考各自的总时长不超过 15 秒；单段超长素材截取前 15 秒。总时长超限返回 37104。同时传入 refs 和显式 aspect_ratio 返回 400。
• Kling 3.0：refs.max=0。图生视频接受 first_frame，但该模式下显式传入 aspect_ratio 会返回 400。
• Kling 3.0 Omni：不支持 first_frame，最多 7 个图片或视频参考。参考素材包含视频时，必须设置 generate_audio=false，否则返回 400。
• 只有模型查询明确支持图生视频时，才使用 first_frame。始终保持 first_frame 与 refs 互斥；end_frame 必须与 first_frame 一起使用。

使用首尾帧生成视频：

curl -s -H "X-API-Key: $VISIONSTORY_API_KEY" -H "Content-Type: application/json" -d '{"model_id": "seedance-2.0", "prompt": "The scene slowly comes alive, gentle camera push-in", "first_frame": {"url": "https://your.site/start.jpg"}, "end_frame": {"url": "https://your.site/end.jpg"}, "duration_sec": 6}' https://openapi.visionstory.ai/api/v1/ai_video

使用可复用素材保持角色一致性：

curl -s -H "X-API-Key: $VISIONSTORY_API_KEY" -H "Content-Type: application/json" -d '{"model_id": "seedance-2.0", "prompt": "The same woman walks through a neon-lit street at night", "refs": [{"asset_id": "YOUR_ASSET_ID"}], "duration_sec": 10}' https://openapi.visionstory.ai/api/v1/ai_video

轮询 AI 视频生成状态

通过 ?video_id= 查询单个任务，或用 ?video_ids=id1,id2,... 一次查询最多 20 个任务，批量响应返回 {"videos": [...]}。每 5–10 秒轮询一次。

Seedance 采用异步审核：拒绝的任务会变为 failed 并退款。Wan 和 Kling 可能同步拒绝内容，返回 HTTP 403 及错误码 37110（提示词）或 37111（图片），不扣费。请同时处理提交错误和 failed 任务状态。

生成失败会全额退还点数。API 不会在失败后自动切换其他模型；返回的 model_id 表示实际使用的模型。

查询与删除 AI 视频

GET /api/v1/ai_videos 按时间倒序列出你的任务。将上一页的 next_cursor 作为 cursor 传入以继续分页，next_cursor=0 表示没有下一页。limit 默认 20，最多 100。DELETE /api/v1/ai_video?video_id= 用于删除任务，且只能删除自己的任务。

通过素材 API 复用媒体

素材是上传后可复用的媒体：上传一次，就能在任意多次生成请求中通过 asset_id 引用，适合反复使用的角色图片、品牌视频或声音样本。重复上传相同内容会返回已有素材，具有幂等性：

curl -s -H "X-API-Key: $VISIONSTORY_API_KEY" -H "Content-Type: application/json" -d '{"url": "https://your.site/character.jpg"}' https://openapi.visionstory.ai/api/v1/asset

{
  "data": {
    "asset_id": "YOUR_ASSET_ID",
    "kind": "image",
    "mime": "image/jpeg",
    "width": 1024,
    "height": 1536,
    "duration_sec": 0,
    "created_at": 1754270000
  }
}

也支持 Base64 inline_data，大小和格式限制与上文媒体输入一致。GET /api/v1/assets 列出你的素材，可用 kind 筛选、cursor / limit 分页。DELETE /api/v1/asset?asset_id= 删除素材，不影响已使用它生成的视频。

AI 视频 API 错误

异步失败（如审核拒绝、供应商错误）不通过 HTTP 错误表示。任务会变为 status=failed，附带 error 对象，并自动退还点数。

频率限制、存储与幂等性

• 并发： Beta 期间按 API Key 限制并发，超限请求会被拒绝，不会排队。
• 频率： 每个账户每 60 秒最多 180 次请求。请使用批量查询（video_ids），轮询间隔保持 5–10 秒。
• 存储： 如需长期保存，请及时下载 video_url。素材会一直保留，直到你将其删除。
• 幂等性： 提交时传入 client_request_id，可安全重试。24 小时内重复使用相同值会返回原任务，不会新建或再次扣费。不使用幂等键时，请在重试前保存返回的 video_id，因为已成功提交后再进行网络级重试，会创建新任务并再次扣费。
• Webhook 暂不支持，目前通过轮询获取结果。
• Beta 接口未来可能增加可选参数和模型，但现有字段及语义不会发生不兼容变更。

相关 VisionStory API 指南

• 快速开始 — 使用同一个密钥完成数字人视频流程。
• 面向 Agent — 让 AI Agent 驱动 AI 视频生成。
• API 参考 — 查看上述接口的完整数据结构。