API 文档AI 模型接口视频

Seedance 视频生成（Dreamina）

Dreamina Seedance 2.0 是新一代视频生成模型，支持文生视频、图生视频、以及视频输入续写 / 编辑。AutoRouter 通过 `/v1/video/generations` 异步任务接口对外提供服务。

Seedance 视频生成（Dreamina）

Dreamina Seedance 2.0 是新一代视频生成模型，支持文生视频、图生视频、以及视频输入续写 / 编辑。AutoRouter 通过 /v1/video/generations 异步任务接口对外提供服务。

Seedance 是异步任务型接口：提交后立即返回 task_id，需要轮询获取结果。

一、支持的模型

模型说明支持能力
dreamina-seedance-2-0标准版 Seedance 2.0，画质优先文生视频、图生视频、视频续写
dreamina-seedance-2-0-fast快速版 Seedance 2.0，延迟更低文生视频、图生视频、视频续写

两个模型都支持视频作为输入（视频续写 / 视频编辑），在 metadata.content 中传入 video_url 即可。

二、通用接口

2.1 提交任务

POST /v1/video/generations

请求头

Header必填说明
Authorization✓Bearer sk-你的APIKey
Content-Type✓application/json

请求体字段

字段类型必填说明
modelstring✓Seedance 模型名，见上表
promptstring✓视频描述提示词
imagestring—图生视频的参考图（URL 或 base64 data URI）；与 images 二选一
imagesstring[]—多图参考（URL 或 base64 data URI）
durationint—视频时长（秒），常见 5 / 10 秒
secondsstring—duration 的字符串形式
metadataobject—Seedance 特有参数容器（见第三节）

响应

{
  "id": "task_xxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "dreamina-seedance-2-0",
  "status": "queued",
  "progress": 0,
  "created_at": 1730000000
}

id / task_id 是 AutoRouter 公开 ID（task_ 前缀），用于后续查询。不等于上游任务 id。

2.2 查询任务状态

GET /v1/video/generations/{task_id}

响应结构为 {code, message, data} 包装。成功时 code 为 "success"，data 是任务详情对象。

响应示例（成功）

{
  "code": "success",
  "message": "",
  "data": {
    "id": 6,
    "task_id": "task_jEctEHDF1vefS2L3HND2JnzXPslnAYby",
    "platform": "45",
    "user_id": 1,
    "group": "default",
    "channel_id": 12,
    "quota": 818125,
    "action": "generate",
    "status": "SUCCESS",
    "fail_reason": "",
    "result_url": "https://ark-acg-...volces.com/xxx.mp4?X-Tos-...",
    "submit_time": 1778236598,
    "start_time": 1778236601,
    "finish_time": 1778236698,
    "created_at": 1778236598,
    "updated_at": 1778236698,
    "progress": "100%",
    "properties": {
      "input": "",
      "upstream_model_name": "dreamina-seedance-2-0-260128",
      "origin_model_name": "dreamina-seedance-2-0"
    },
    "data": {
      "id": "cgt-20260508183637-m6gj8",
      "seed": 42,
      "draft": false,
      "model": "dreamina-seedance-2-0-260128",
      "ratio": "16:9",
      "usage": {
        "total_tokens": 108900,
        "completion_tokens": 108900
      },
      "status": "succeeded",
      "content": {
        "video_url": "https://ark-acg-...volces.com/xxx.mp4?X-Tos-..."
      },
      "duration": 5,
      "resolution": "720p",
      "service_tier": "default",
      "generate_audio": true,
      "framespersecond": 24,
      "execution_expires_after": 172800,
      "created_at": 1778236598,
      "updated_at": 1778236696
    }
  }
}

data 字段说明

字段类型说明
idint内部任务自增 ID
task_idstringAutoRouter 公开任务 ID（以 task_ 开头），用于后续查询
platformstring上游平台编号
user_idint用户 ID
groupstring所属分组
channel_idint实际调用的渠道 ID
quotaint本次任务扣费的 quota 原始值
actionstring任务动作，通常为 generate
statusstring任务状态：SUBMITTED / QUEUED / IN_PROGRESS / SUCCESS / FAILURE
fail_reasonstring失败原因（仅 status = FAILURE 时非空）
result_urlstring视频结果 URL（仅成功时返回，为上游临时链接）
progressstring进度，形如 "100%"
submit_time / start_time / finish_timeint64提交 / 开始 / 完成的 Unix 时间戳（秒）
created_at / updated_atint64记录创建 / 最近更新时间
properties.upstream_model_namestring实际发给上游的模型名
properties.origin_model_namestring客户端请求的模型名
dataobject上游原始响应（含 usage、content.video_url、resolution 等）

状态枚举

状态说明
SUBMITTED已提交
QUEUED已进入上游队列
IN_PROGRESS生成中
SUCCESS已完成，result_url 为视频地址
FAILURE生成失败，fail_reason 为失败原因

2.3 下载视频内容

GET /v1/videos/{task_id}/content

直接返回视频二进制流（Content-Type: video/mp4）。AutoRouter 自动代理上游 URL。

强烈推荐使用 /content 代理接口下载视频，而不是直接访问 result_url。后者是上游的临时链接，有效期有限。

三、Seedance 特有参数（metadata）

所有 Seedance 特有字段都通过请求体的 metadata 对象传递，系统会透传给上游。

3.1 分辨率 / 宽高比 / 时长

字段类型说明取值示例
resolutionstring分辨率档位480p 720p 1080p
ratiostring宽高比16:9 9:16 1:1 4:3 3:4 21:9 adaptive（自适应）
durationint视频时长（秒），覆盖顶层 duration5 10
framesint指定帧数（可选，与 duration 互斥）如 121
seedint随机种子0 ~ 2^31-1

3.2 镜头与内容控制

字段类型说明
camera_fixedbool是否固定镜头（true = 镜头静止）
watermarkbool是否添加官方水印

3.3 高级参数

字段类型说明
service_tierstring服务档位，影响速度与配额（如 auto / default / priority）
execution_expires_afterint任务执行超时时间（秒）
generate_audiobool是否同步生成音频
draftbool草稿模式（更快速、更便宜，质量略降）
return_last_framebool是否在响应中返回视频最后一帧图片
callback_urlstring任务完成后的回调通知 URL

3.4 多模态输入（content 数组）

除了顶层 image / images 字段外，你也可以直接在 metadata.content 传递多模态输入数组，支持图片和视频混合输入：

{
  "model": "dreamina-seedance-2-0",
  "prompt": "把这段视频延长，让猫咪走到画面外",
  "metadata": {
    "content": [
      {
        "type": "video_url",
        "video_url": {
          "url": "https://example.com/cat.mp4"
        }
      }
    ],
    "resolution": "720p"
  }
}
type用途
image_url + image_url.url图片参考（图生视频）
video_url + video_url.url视频输入（视频续写 / 编辑）

四、完整调用示例

# Step 1: 提交任务
curl -X POST https://autorouter.top/v1/video/generations \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0",
    "prompt": "一只猫在月球表面漫步，背景是璀璨的星空",
    "duration": 5,
    "metadata": {
      "resolution": "720p",
      "ratio": "16:9",
      "seed": 42
    }
  }'

# Step 2: 轮询任务
curl https://autorouter.top/v1/video/generations/task_abc123 \
  -H "Authorization: Bearer sk-你的APIKey"

# Step 3: 下载视频
curl https://autorouter.top/v1/videos/task_abc123/content \
  -H "Authorization: Bearer sk-你的APIKey" \
  -o cat_on_moon.mp4
curl -X POST https://autorouter.top/v1/video/generations \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0",
    "prompt": "让这只猫跳起来",
    "image": "https://example.com/cat.jpg",
    "duration": 5,
    "metadata": {
      "resolution": "720p",
      "ratio": "16:9"
    }
  }'
# 视频续写 / 编辑
curl -X POST https://autorouter.top/v1/video/generations \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0",
    "prompt": "延长这段视频，让猫咪走到画面外",
    "metadata": {
      "content": [
        {
          "type": "video_url",
          "video_url": {
            "url": "https://example.com/cat-original.mp4"
          }
        }
      ],
      "resolution": "720p",
      "duration": 5
    }
  }'
# Fast 版：速度优先，延迟更低
curl -X POST https://autorouter.top/v1/video/generations \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-fast",
    "prompt": "赛博朋克城市街景，霓虹灯闪烁，雨夜",
    "duration": 5,
    "metadata": {
      "resolution": "720p",
      "ratio": "16:9",
      "camera_fixed": false,
      "generate_audio": true
    }
  }'

五、错误处理

5.1 HTTP 400 参数错误

  • 模型不存在或未授权：model not allowed
  • prompt 为空：prompt is required
  • 分辨率 / 时长参数非法：由上游返回具体错误

5.2 HTTP 401 / 403 鉴权错误

  • 401 Unauthorized：API Key 无效或已过期
  • 403 Forbidden：API Key 无权访问此模型（检查 token 模型白名单）

5.3 HTTP 402 余额不足

返回 insufficient user quota 错误。

5.4 任务 failed 状态

常见原因：

原因处理建议
内容审核失败修改 prompt，避免敏感内容
图片 / 视频 URL 不可访问确保 URL 公开可访问，或改用 base64
上游超时稍后重试，或切换到 dreamina-seedance-2-0-fast

任务 failed 时 AutoRouter 会自动退回已扣费用。

六、常见问题

Seedance 和 PixVerse 的接口路径有什么不同？

  • Seedance：POST /v1/video/generations
  • PixVerse：POST /v1/videos（OpenAI Sora 兼容路径）

两者的请求字段结构类似，但特有参数通过各自的 metadata 对象传递。下载视频都使用 GET /v1/videos/{task_id}/content 代理接口。

如何选择 dreamina-seedance-2-0 vs dreamina-seedance-2-0-fast？

  • 画质优先 / 视频续写：dreamina-seedance-2-0
  • 速度优先 / 低延迟 / 批量生成：dreamina-seedance-2-0-fast

两个模型的核心能力一致，差异在于画面质量与生成速度的权衡。

支持哪些分辨率和时长？

resolution 常见取值：480p / 720p / 1080p。duration 常见取值 5 秒或 10 秒。

传入不支持的组合上游会直接返回错误。

任务通常多久能完成？

典型耗时参考：

  • dreamina-seedance-2-0-fast：10 ~ 30 秒
  • dreamina-seedance-2-0（720p / 5s）：30 ~ 60 秒
  • dreamina-seedance-2-0（1080p / 10s）：60 ~ 180 秒
  • 视频输入场景：视视频长度而定，可能更久

建议轮询间隔 3~5 秒，最长等待 10 分钟。

视频 URL 会过期吗？

上游返回的原始视频 URL 是临时链接，有效期有限。建议获取后尽快下载或转存到你自己的存储。

能同时使用多图参考吗？

可以。使用顶层 images 字段传入图片 URL 数组，或通过 metadata.content[] 传入多个 image_url 条目。系统会将所有图片按顺序拼接到上游请求的 content 数组中。

generate_audio 参数有用吗？

metadata.generate_audio: true 会请求上游同步生成视频音轨。具体音频质量与支持的场景请参考平台运营说明。

PixVerse 视频生成

[PixVerse](https://platform.pixverse.ai) 是一家提供高质量 AI 视频生成服务的平台。AutoRouter 接入 PixVerse OpenAPI v2，通过 OpenAI 兼容的 `/v1/videos` 接口对外提供服务，覆盖 PixVerse 全部 8 个模型版本的文生视频

Veo 3.1 视频生成

Veo 3.1 是 Google 推出的新一代视频生成模型，支持文本/图片输入、最高 4K 分辨率输出，并原生支持同步语音与音效生成。AutoRouter 通过统一的 `/v1/video/generations` 异步任务接口对外提供服务。

目录

Seedance 视频生成（Dreamina）一、支持的模型二、通用接口2.1 提交任务请求头请求体字段响应2.2 查询任务状态响应示例（成功）data 字段说明状态枚举2.3 下载视频内容三、Seedance 特有参数（metadata）3.1 分辨率 / 宽高比 / 时长3.2 镜头与内容控制3.3 高级参数3.4 多模态输入（content 数组）四、完整调用示例五、错误处理5.1 HTTP 400 参数错误5.2 HTTP 401 / 403 鉴权错误5.3 HTTP 402 余额不足5.4 任务 failed 状态六、常见问题