本页目录
Seedance 2.0 API
通过一套异步 API 创建 Seedance 2.0 文生视频和图生视频任务。首个公开版本暂不开放参考视频生成或视频编辑。
REST API · v1 · 异步任务
完成第一次调用
选择文生视频或图生视频，使用唯一 Idempotency-Key，然后轮询返回的 task ID。
- 1
创建 API Key
在 imya 账户设置中生成一枚密钥。
- 2
选择模式
仅使用 text-to-video 或 image-to-video。
- 3
获取结果
轮询 task ID，直到任务成功或失败。
身份验证与幂等
API Key 通过 Bearer Token 发送。每个生成 POST 还必须带唯一 Idempotency-Key，安全重试不会重复创建任务或扣费。
Authorization: Bearer YOUR_IMYA_API_KEY
Content-Type: application/json
Idempotency-Key: YOUR_UNIQUE_REQUEST_KEY创建视频生成任务
创建异步 Seedance 任务，并返回服务端根据本次请求实时计算的 credits_reserved。
/v1/videos/generations# Text to video
curl https://imya.ai/v1/videos/generations \
-H "Authorization: Bearer YOUR_IMYA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: seedance-t2v-order-001" \
-d '{
"model": "seedance-2.0",
"mode": "text-to-video",
"prompt": "A coastal train passing cliffs at sunrise",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}'
# Image to video
curl https://imya.ai/v1/videos/generations \
-H "Authorization: Bearer YOUR_IMYA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: seedance-i2v-order-001" \
-d '{
"model": "seedance-2.0",
"mode": "image-to-video",
"prompt": "Wind moves the fabric as the camera arcs right",
"image_url": "https://cdn.example.com/first-frame.jpg",
"duration": 8,
"resolution": "1080p",
"aspect_ratio": "16:9",
"generate_audio": true
}'查询任务
返回最新任务状态、最终积分、生成的 MP4 或净化后的错误。请勿快于每 5 秒轮询一次。视频结果链接可能是临时的，请及时下载；生产 Beta 暂不保证 API 视频保留 7/30 天。
/v1/tasks/{task_id}curl https://imya.ai/v1/tasks/task_0123456789abcdef0123456789abcdef \
-H "Authorization: Bearer YOUR_IMYA_API_KEY"请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 使用 seedance-2.0。 |
| mode | string | 是 | text-to-video 或 image-to-video。 |
| prompt | string | 是 | 生成说明，3 到 20,000 字符。 |
| image_url | string | 条件必填 | 公开 HTTPS 首帧，仅图生视频必填。 |
| last_frame_url | string | 否 | 图生视频可选公开 HTTPS 尾帧。 |
| duration | number | 否 | 4 到 15 秒整数，默认 5 秒。 |
| resolution | string | 否 | 480p、720p 或 1080p，默认 720p。 |
| aspect_ratio | string | 否 | 1:1、4:3、3:4、16:9、9:16、21:9 或 adaptive。 |
| generate_audio | boolean | 否 | 是否生成音频，默认 true。 |
| web_search | boolean | 否 | 仅文生视频可用，默认 false。 |
返回结构
{
"id": "task_0123456789abcdef0123456789abcdef",
"status": "pending",
"model": "seedance-2.0",
"credits_reserved": 625
}{
"id": "task_0123456789abcdef0123456789abcdef",
"status": "succeeded",
"model": "seedance-2.0",
"credits_used": 625,
"data": [
{
"url": "https://media.example.com/generated/example.mp4"
}
]
}实时积分计费
服务端会根据模式、分辨率、时长和 API Key 所属用户的当前套餐计算 credits_reserved。当前 Imya 积分计算不会因音频或网络搜索开关改变。返回示例中的数字只用于展示结构；客户端必须使用本次响应返回的值，不要缓存或自行写死 Seedance 价格。
任务状态
pending任务已接收，正在等待处理。
processing模型正在生成视频。
succeeded生成完成，data 中包含 MP4。
failed生成失败，请读取净化后的 error 对象。
错误码
400缺少 Idempotency-Key 或 JSON 格式错误。
401API Key 缺失或无效。
402账户积分不足。
403API 账户已停用。
409同一幂等键被用于不同请求体。
413请求体超过 64 KiB。
422模式、提示词、图片、时长、分辨率或比例无效。
429达到速率或并发任务上限。
5xx本次请求无法完成或提交。
接入前想先测试 Seedance？
打开 Seedance 2.0 在线工具，比较文生视频和图生视频。
在线试用 Seedance 2.0