1. 视频生成及获取
SD2 API
  • seed2最强视频生成
    • 用量与身份
      • 查询当前用量模式与 owner identity
    • 视频生成及获取
      • 创建视频任务
        POST
      • 查询任务
        GET
    • 图床功能
      • 两步式上传签名(Presign)
      • 一步式图床上传(仅上传并返回 URL)
    • 真人素材库
      • 提交共享素材登记(素材库)
      • 查询当前用户素材列表(Bearer)
      • 查询当前用户单个素材(Bearer)
      • 删除当前用户素材(Bearer)
  • health
    • Web 进程健康检查
      GET
  1. 视频生成及获取

创建视频任务

POST
/v1/video/generations
统一创建入口。虽然上游文档常把文生视频、首帧生视频、首尾帧生视频、多模态参考生成、编辑视频、延长视频分开展示,当前代理程序仍统一使用这一条接口收口。
当前常见请求示范已在下方提供:
文生视频:只传 prompt + 可选 metadata
1080p 视频:使用 seed-2-1080 / seed-2-vision-1080 并传 metadata.resolution = "1080p"
首帧生视频:使用顶层 image
首尾帧生视频:使用 metadata.first_frame_image + metadata.last_frame_image
多模态参考生成:使用 metadata.reference_images / reference_videos / reference_audios
编辑视频:mode=video_edit,必须传 metadata.reference_videos
延长视频:mode=video_extend,只允许并必须传 metadata.reference_videos
关键约束:
model 与 prompt 必填
mode 是代理侧场景标记,只用于本地校验和 Web 历史恢复,不会写入上游 canonical_request_json
顶层 image、首尾帧、reference_* 三类场景互斥
first_frame_image 与 last_frame_image 必须成对出现
metadata 可以省略;顶层 duration 会被归一化到 metadata.duration
seed-2-1080 / seed-2-vision-1080 必须使用 1080p;非 1080 模型不能使用 1080p
成功响应只返回代理任务 id 与 proxy_meta,不直接返回上游任务结果
素材值既可以是公网 URL,也可以是已登记共享素材的 asset://<asset_id>。

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Body 参数application/json必填

示例
文生视频:只用提示词生成视频,示范顶层 duration 兼容别名。
{
    "mode": "multimodal",
    "model": "seed-2-fast",
    "prompt": "清晨阳光穿过落地窗,一杯果茶放在木桌上,镜头缓慢推进,冷凝水顺着杯壁滑落,广告级产品特写。",
    "duration": 5,
    "metadata": {
        "ratio": "16:9",
        "resolution": "720p",
        "generate_audio": true,
        "watermark": false
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.seedance.show/v1/video/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "mode": "multimodal",
    "model": "seed-2-fast",
    "prompt": "清晨阳光穿过落地窗,一杯果茶放在木桌上,镜头缓慢推进,冷凝水顺着杯壁滑落,广告级产品特写。",
    "duration": 5,
    "metadata": {
        "ratio": "16:9",
        "resolution": "720p",
        "generate_audio": true,
        "watermark": false
    }
}'

返回响应

🟢202
application/json
任务已 accepted;返回代理任务 id 和代理侧冻结/队列信息,不直接返回上游视频结果
Bodyapplication/json

示例
{
  "data": {
    "id": "task-000001",
    "status": "pending_dispatch"
  },
  "proxy_meta": {
    "frozen_cost_units": 264,
    "selected_key_scope": "platform",
    "queue_state": "pending_dispatch",
    "queue_position": 1
  }
}
🟠400
🟠401
🟠402
🟠409
🟠429
🔴502
修改于 2026-06-03 05:53:31
上一页
查询当前用量模式与 owner identity
下一页
查询任务
Built with