Seedance 2.0 文生视频 API 文档

使用 seedance-2.0-text-to-video 模型生成视频内容

Overview

本文档说明如何使用 seedance-2.0-text-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: Yes
• Description: 用于描述目标视频内容的文本提示词
• Max Length: 20000 characters

aspect_ratio

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

ratio

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

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-text-to-video 当前公开积分规则如下：

Request Example

{
  "model": "seedance-2.0-text-to-video",
  "input": {
    "prompt": "A slow dolly shot through a futuristic botanical lab with soft volumetric light",
    "ratio": "16:9",
    "resolution": "720p",
    "duration": 5,
    "generate_audio": false,
    "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-text-to-video",
    "state": "waiting",
    "param": "{\"model\":\"seedance-2.0-text-to-video\",\"input\":{\"prompt\":\"A slow dolly shot through a futuristic botanical lab with soft volumetric light\",\"ratio\":\"16:9\",\"resolution\":\"720p\",\"duration\":5,\"generate_audio\":false}}",
    "resultJson": null,
    "failCode": null,
    "failMsg": null,
    "costTime": null,
    "completeTime": null,
    "createTime": 1757584164490
  }
}

Response Parameters

Success Result Structure

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

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

Usage Flow

1. 调用 POST /api/v1/jobs/createTask
2. 从响应中提取 taskId
3. 轮询 GET /api/v1/jobs/recordInfo?taskId=...
4. 等待 state 变成 success 或 fail
5. 成功后从 resultJson 中读取输出视频 URL

Notes

• API 调用与网页端共用同一套积分余额和计费规则
• resolution、duration 和音频设置会影响积分消耗
• 如果同时传 ratio 和 aspect_ratio，优先使用 ratio

Error Codes