Seedance 2.0 参考生视频 API 文档

使用 seedance-2.0-reference-to-video 模型生成参考驱动视频内容

Overview

本文档说明如何使用 seedance-2.0-reference-to-video 模型进行参考生视频。

集成流程分为两步：

1. 创建生成任务
2. 查询任务状态和结果

Authentication

所有 API 请求都需要在请求头中携带 Bearer Token：

Authorization: Bearer YOUR_API_KEY

获取 API Key：

1. 打开 API Keys 页面
2. 点击 Create API Key
3. 在请求头中加入：Authorization: Bearer YOUR_API_KEY

1. 创建生成任务

API Information

• URL: POST https://aigptimage.com/api/v1/jobs/createTask
• Content-Type: application/json

Request Parameters

Model Parameter

model 参数用于指定对外公开的参考生视频模型。

Note: model 的值必须完全匹配，并且必须使用本页展示的公开模型 ID。

input Object Parameters

prompt

• Type: string
• Required: No
• Description: 描述目标视频以及参考素材使用方式的提示词
• Max Length: 20000 characters

reference_image_urls

• Type: string[]
• Required: No
• Description: 参考图片 URL，用于角色、风格、场景等信息引导

reference_video_urls

• Type: string[]
• Required: No
• Description: 参考视频 URL，用于动作、镜头语言或节奏引导

reference_audio_urls

• Type: string[]
• Required: No
• Description: 参考音频 URL，用于节奏或声音风格引导

aspect_ratio

• Type: string
• Required: No
• Description: 对外 API 接受的便捷比例字段，内部会映射为 ratio
• Common Options: 16:9, 9:16, 1:1, 3:4

ratio

• Type: string
• Required: No
• Description: 输出视频比例。如果同时传 ratio 和 aspect_ratio，优先使用 ratio
• Common Options: 16:9, 9:16, 1:1, 3:4

resolution

• Type: string
• Required: No
• Description: 输出分辨率，同时也会影响积分消耗
• Options: 480p, 720p, 1080p

duration

• Type: number
• Required: No
• Description: 视频时长，单位秒

generate_audio

• Type: boolean
• Required: No
• Description: 是否为输出视频生成音频
• Default Value: false

web_search

• Type: boolean
• Required: No
• Description: 是否在生成前启用联网搜索辅助
• Default Value: false

nsfw_checker

• Type: boolean
• Required: No
• Description: 控制平台侧内容过滤
• Default Value: false
• Behavior: 如果传 false，平台侧内容过滤会被关闭，结果会直接返回模型原始输出

积分消耗

seedance-2.0-reference-to-video 当前公开积分规则如下：

Request Example

{
  "model": "seedance-2.0-reference-to-video",
  "input": {
    "prompt": "Use the reference images for character identity and the reference video for camera rhythm. Generate a dramatic training sequence with fast movement and cinematic lighting.",
    "reference_image_urls": ["https://cdn.example.com/ref-1.png"],
    "reference_video_urls": ["https://cdn.example.com/ref-motion.mp4"],
    "ratio": "16:9",
    "resolution": "720p",
    "duration": 5,
    "nsfw_checker": false
  }
}

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_xxxxxxxxxxxxx"
  }
}

Response Parameters

2. 查询任务状态

API Information

• URL: GET https://aigptimage.com/api/v1/jobs/recordInfo
• Parameter: taskId（URL 查询参数）

Request Example

GET https://aigptimage.com/api/v1/jobs/recordInfo?taskId=task_xxxxxxxxxxxxx

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_xxxxxxxxxxxxx",
    "model": "seedance-2.0-reference-to-video",
    "state": "waiting",
    "param": "{\"model\":\"seedance-2.0-reference-to-video\",\"input\":{\"prompt\":\"Use the reference images for character identity and the reference video for camera rhythm. Generate a dramatic training sequence with fast movement and cinematic lighting.\",\"reference_image_urls\":[\"https://cdn.example.com/ref-1.png\"],\"reference_video_urls\":[\"https://cdn.example.com/ref-motion.mp4\"],\"ratio\":\"16:9\",\"resolution\":\"720p\",\"duration\":5}}",
    "resultJson": null,
    "failCode": null,
    "failMsg": null,
    "costTime": null,
    "completeTime": null,
    "createTime": 1757584164490
  }
}

Success Result Structure

参考生视频任务成功时，resultJson 通常结构如下：

{
  "resultUrls": ["https://your-cdn.example.com/result-1.mp4"]
}

Usage Flow

1. 先准备公开可访问的参考文件 URL
2. 调用 POST /api/v1/jobs/createTask
3. 从响应中提取 taskId
4. 轮询 GET /api/v1/jobs/recordInfo?taskId=...
5. 成功后从 resultJson 中读取输出视频 URL

Notes

• API 调用与网页端共用同一套积分余额和计费规则
• 参考图片、视频、音频都应使用你的服务端可以安全传递的公开 URL
• resolution、duration 和音频设置会影响积分消耗

Error Codes