视频系列通用视频

查询视频生成任务

查询 /v1/video/generations 视频任务状态与结果。Seedance 返回 {code, data} 任务记录，成功状态为 data.status: SUCCESS，视频地址为 data.result_url，上游快照在 data.data。如需规范化 object: video 响应及 metadata.last_frame_url，使用 GET /v1/videos/{task_id}；视频 URL 通常具有时效性，建议获取后及时下载或转存。

Authorization

bearerAuth

AuthorizationBearer <token>

使用 Authorization Bearer API Key 进行鉴权。

In: header

Path Parameters

task_id*string

视频生成任务 ID。

Response Body

`application/json`

`application/json`

`application/json`

curl -X GET "https://example.com/v1/video/generations/task_123456"

{
  "code": "success",
  "message": "string",
  "data": {
    "task_id": "string",
    "status": "string",
    "result_url": "http://example.com",
    "data": {}
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string"
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string"
  }
}

视频生成

创建视频生成任务。该通用接口覆盖 HappyHorse、Seedance、Veo、万相等 `/v1/video/generations` 提供商。使用 Seedance 2.0 / 2.5 时，通用字段会转换为官方 `content[]` 格式：`prompt` 转为文本内容，`image` 或 `images` 转为参考图片，`metadata.video_url` 转为参考视频，`metadata.audio_url` 转为参考音频，`size` 转为 `resolution`，`metadata.ratio` 转为 `ratio`。创建成功后保存返回的任务 ID，并通过 `GET /v1/video/generations/{task_id}` 轮询结果。 Seedance 2.0 / 2.5 素材支持自动上传：在图片、视频或音频素材字段中直接传入公网可访问的 `https://` 链接，系统会自动识别并上传素材，无需提前调用 `/api/assets/upload`。使用 Wan 3.0 时，`image` 或 `images[]` 的前两张图片会转换为 `first_frame` 和 `last_frame`，`reference_images[].url` 转换为 `reference_image`，`video.url` 转换为 `reference_video`。需要参考音频、文件、网页或完整控制原生字段时，通过 `metadata.input.media` 和 `metadata.parameters` 传入；非空的 `metadata.input.media` 会替换所有快捷媒体字段。 Seedance 2.5 任务类型放在顶层 `omni_reference_task_type`，兼容 `metadata.omni_reference_task_type`（顶层优先）；`metadata.content` 非空时完整替换快捷媒体映射。编辑使用 `duration: -1` 和 `metadata.ratio: adaptive`；延长也要求 `metadata.ratio: adaptive`。`seconds` 与 `duration` 不要传冲突值。Seedance 的 `watermark`、`return_last_frame`、`seed`、`camera_fixed`、`draft`、`service_tier`、`execution_expires_after`、`priority`、`safety_identifier`、`callback_url`、`output_format`、`tools`、`frames` 放在 `metadata` 下；所有内置 Seedance 路径保留显式 false/0，多视频和多音频数组不会截为第一项。

Grok 视频生成

Next Page