Skip to main content
POST
https://www.geeknow.top
/
v1
/
videos
curl -X POST https://www.geeknow.top/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-pro",
    "prompt": "雨夜街头，一位穿红色雨衣的女孩慢跑，镜头缓慢跟拍，电影感光影",
    "duration": 6,
    "aspect_ratio": "16:9"
  }'

{
  "id": "task_01jz8s3dbke8p9vq2m8r9a7gk4",
  "object": "video",
  "created": 1790557800,
  "model": "seedance-2.0-pro",
  "status": "queued"
}

​
Seedance-2 创建视频任务

Seedance-2 视频生成接口用于提交文生视频、首帧生视频、首尾帧生视频和参考素材生成任务。
  • 异步处理模式，提交成功后返回视频任务 ID
  • 支持 seedance-2.0-lite、seedance-2.0-pro、seedance-2.0-fast
  • 支持首帧图、尾帧图、参考图、参考视频和参考音频 URL
  • 支持使用 asset://{asset_id} 引用已创建的 Seedance-2 素材
  • 支持 application/json，也支持仅 URL 字段的 multipart/form-data

​
方法与路径

POST /v1/videos

curl -X POST https://www.geeknow.top/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-pro",
    "prompt": "雨夜街头，一位穿红色雨衣的女孩慢跑，镜头缓慢跟拍，电影感光影",
    "duration": 6,
    "aspect_ratio": "16:9"
  }'

​
素材 ID 引用规则

通过 创建素材 得到的 Result.Id 是裸素材 ID，例如 asset-20260528143012-a8x7k。在视频生成请求中引用它时，需要加上 asset:// 前缀： 
asset://asset-20260528143012-a8x7k
asset:// 表示引用素材库中已注册的图片、视频或音频素材。它不是公网 URL，不能直接在浏览器中打开；查询状态时仍然使用裸素材 ID： 
GET /api/asset/get?id=asset-20260528143012-a8x7k
支持 asset://{asset_id} 的字段：
字段用途示例
first_image / first_frame_url首帧图"first_image": "asset://asset-20260528143012-a8x7k"
last_image / last_frame_url尾帧图"last_image": "asset://asset-20260528143351-b2n6q"
reference_images / reference_image_urls多张参考图"reference_images": ["asset://asset-20260528143012-a8x7k"]
reference_videos / reference_video_urls多个参考视频"reference_videos": ["asset://asset-20260528143708-k9m2p"]
reference_audios / audio_url参考音频"reference_audios": ["asset://asset-20260528144123-r4s6n"]
使用素材 ID 前，建议先调用 GET /api/asset/get，确认 Result.Status 已经变为 Active。

​
响应示例

{
  "id": "task_01jz8s3dbke8p9vq2m8r9a7gk4",
  "object": "video",
  "created": 1790557800,
  "model": "seedance-2.0-pro",
  "status": "queued"
}

​
认证

Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
required
模型名称。支持 seedance-2.0-lite、seedance-2.0-pro、seedance-2.0-fast。
​
prompt
string
required
视频生成提示词。
​
duration
integer
视频时长，单位秒。传入时必须大于等于 1。
​
aspect_ratio
string
画幅比例。支持 16:9、9:16、1:1、4:3、3:4、21:9、adaptive。
​
ratio
string
aspect_ratio 的兼容字段。未传 aspect_ratio 时使用。
​
first_image
string
首帧图 URL 或素材引用 URI。可以传公网 URL，也可以传 asset://asset-20260528143012-a8x7k。
​
last_image
string
尾帧图 URL 或素材引用 URI。通常与 first_image 一起使用，用于首尾帧过渡。
​
first_frame_url
string
first_image 的兼容字段。未传 first_image 时使用。
​
last_frame_url
string
last_image 的兼容字段。未传 last_image 时使用。
​
reference_images
array<string>
参考图片 URL 或素材引用 URI 数组。适合传入主体、风格或产品参考图。
​
reference_image_urls
array<string>
reference_images 的兼容字段。未传 reference_images 时使用。
​
reference_videos
array<string>
参考视频 URL 或素材引用 URI 数组。适合传入镜头运动或动作参考。
​
reference_video_urls
array<string>
reference_videos 的兼容字段。未传 reference_videos 时使用。
​
reference_audios
array<string>
参考音频 URL 或素材引用 URI 数组。
​
audio_url
string
单个参考音频 URL 或素材引用 URI。未传 reference_audios 时会转换为 reference_audios: [audio_url]。
​
generate_audio
boolean
是否启用音频生成或音频参考。传 true 时必须同时提供 reference_audios 或 audio_url；不传表示省略该参数，传 false 表示显式关闭。

​
Response

​
id
string
视频任务 ID。后续用 GET /v1/videos/{id} 查询结果。
​
object
string
对象类型，通常为 video。
​
created
integer
任务创建时间戳。
​
model
string
本次任务使用的模型。
​
status
string
任务状态。常见值为 queued、in_progress、completed、failed。
​
video_url
string
任务完成后的公开视频 URL。提交阶段通常为空，查询完成任务时返回。
​
actualDuration
integer
实际生成的视频时长。上游返回该字段时透出。
​
totalTokens
integer
任务计费用量。上游返回该字段时透出。
​
error
string
任务失败原因。

​
使用场景

​
文生视频

只传 model、prompt、duration 和 aspect_ratio，适合从纯文本生成视频。 
{
  "model": "seedance-2.0-fast",
  "prompt": "清晨海边，航拍镜头掠过浪花，阳光穿过薄雾",
  "duration": 5,
  "aspect_ratio": "16:9"
}

​
首帧生视频

传入 first_image，让静态图中的主体动起来。 
{
  "model": "seedance-2.0-pro",
  "prompt": "让人物自然抬头，微笑，看向镜头",
  "duration": 6,
  "aspect_ratio": "9:16",
  "first_image": "https://example.com/assets/person-first-frame.png"
}

​
使用素材 ID 生成视频

先用 创建素材 注册图片、视频或音频，再把返回的 Result.Id 拼成 asset://{asset_id} 传入视频生成请求。 
{
  "model": "seedance-2.0-pro",
  "prompt": "参考素材中的产品外观和镜头运动，生成一条广告感短视频",
  "duration": 6,
  "aspect_ratio": "adaptive",
  "reference_images": ["asset://asset-20260528143012-a8x7k"],
  "reference_videos": ["asset://asset-20260528143708-k9m2p"],
  "reference_audios": ["asset://asset-20260528144123-r4s6n"],
  "generate_audio": true
}

​
多参考素材生成

同时传参考图、参考视频和参考音频，用于控制主体外观、镜头语言和声音风格。 
{
  "model": "seedance-2.0-pro",
  "prompt": "参考产品图和镜头运动生成一条广告感短视频",
  "duration": 6,
  "aspect_ratio": "adaptive",
  "reference_images": ["https://example.com/assets/product.png"],
  "reference_videos": ["https://example.com/assets/motion.mp4"],
  "reference_audios": ["https://example.com/assets/music.mp3"],
  "generate_audio": true
}

​
注意事项

  • prompt 和 model 必填。
  • duration 传入时必须大于等于 1。
  • aspect_ratio 只支持枚举值：16:9、9:16、1:1、4:3、3:4、21:9、adaptive。
  • generate_audio 不传表示省略；显式传 false 会作为关闭音频参数发送。
  • multipart/form-data 只支持 URL 字段，不支持直接上传二进制文件。
  • asset://{asset_id} 只用于视频生成的素材字段；查询素材状态时不要给 id 参数加 asset:// 前缀。

​
相关页面