跳转到主要内容
POST
/
api
/
open-api
/
v1
/
seedance
/
videos
Create Seedance Video Task
curl --request POST \
  --url https://www.jimmyai.cn/api/open-api/v1/seedance/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "duration": 123,
  "images": [
    "<string>"
  ],
  "ratio": "<string>",
  "first_image": "<string>",
  "last_image": "<string>",
  "reference_videos": [
    "<string>"
  ],
  "reference_audios": [
    "<string>"
  ]
}
'
{
  "code": "20000",
  "msg": "ok",
  "data": {
    "task_id": "<string>",
    "status": "<string>",
    "model": "<string>",
    "created_at": 123
  }
}
创建 Seedance 2.0 Mini 视频生成任务。提交成功后返回 task_id，请使用 查询视频任务 轮询状态，完成后从 result.video_url 获取视频地址。
本接口与 创建 Seedance 满血版视频 共用 POST /api/open-api/v1/seedance/videos。满血版见满血版文档，SP 经济版见 SP 创建视频。

​
模型

线路请求 model计费模型名时长
Mini 标准seedance2.0-miniseedance2.0-mini-{resolution}4–15 秒
Mini 视频参考seedance2.0-mini-videoseedance2.0-mini-{resolution}-video4–15 秒
{resolution} 为 480p、720p（默认）或 1080p，由请求字段 resolution 指定。

​
计费说明

Mini 线路按 秒 计费，不同分辨率对应不同单价。
项目说明
计费方式单价（元/秒）× 计费秒数
单价来源以 控制台定价 中对应计费模型名为准（如 seedance2.0-mini-720p）
分辨率480p、720p（默认）、1080p；通过 resolution 字段指定
生成时长duration 字段，范围 4–15 秒，默认 5 秒

​
计费秒数

  • seedance2.0-mini：计费秒数 = 请求的 duration。
  • seedance2.0-mini-video（含参考视频）：计费秒数 = duration + 参考视频时长（取 reference_videos 中第一个视频的秒数，四舍五入取整）。若无法获取参考视频时长，则回退为仅按 duration 计费。

​
计费示例

假设控制台 seedance2.0-mini-720p 单价为 0.05 元/秒：
场景请求计费秒数费用
图生视频 5 秒model: seedance2.0-mini，duration: 5，resolution: 720p50.05 × 5 = 0.25 元
视频参考 8 秒 + 参考视频 3 秒model: seedance2.0-mini-video，duration: 8，参考视频 3 秒110.05 × 11 = 0.55 元
实际单价因分辨率与用户专属定价而异，提交前可在控制台查看当前报价。

​
请求参数

字段类型必填说明
modelstring是seedance2.0-mini 或 seedance2.0-mini-video
promptstring是视频生成提示词
durationint是时长（秒），4–15，默认 5
resolutionstring否输出分辨率：480p、720p（默认）、1080p
ratiostring否画面比例，如 16:9、9:16、1:1
imagesstring[]否参考图列表
first_imagestring否首帧图片
last_imagestring否尾帧图片
reference_videosstring[]否参考视频；仅 seedance2.0-mini-video 支持
reference_audiosstring[]否参考音频；须搭配参考图、参考视频或首尾帧

​
素材说明

  • 可直接传入公网可访问的 https:// URL。
  • 也可先通过 文件上传 获取 URL 后引用。
  • 无需满血版素材审核流程。

​
约束

  • images（参考图模式）与 first_image / last_image（首尾帧模式）不可同时使用。
  • reference_videos 仅 seedance2.0-mini-video 支持。
  • reference_audios 不能单独使用，须搭配参考图、参考视频或首尾帧。

​
示例

​
Mini — 参考图生视频

curl -X POST 'https://www.jimmyai.cn/api/open-api/v1/seedance/videos' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance2.0-mini",
    "prompt": "人物缓缓转头，微风拂动发丝",
    "duration": 6,
    "resolution": "720p",
    "ratio": "9:16",
    "images": ["https://example.com/ref-1.jpg"]
  }'

​
Mini — 首尾帧图生视频

curl -X POST 'https://www.jimmyai.cn/api/open-api/v1/seedance/videos' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance2.0-mini",
    "prompt": "雨夜街头，女孩回头微笑，电影感镜头推进",
    "duration": 5,
    "resolution": "1080p",
    "ratio": "16:9",
    "first_image": "https://example.com/start.png"
  }'

​
Mini 视频参考

curl -X POST 'https://www.jimmyai.cn/api/open-api/v1/seedance/videos' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance2.0-mini-video",
    "prompt": "延续参考视频的运动节奏与镜头语言",
    "duration": 8,
    "resolution": "720p",
    "ratio": "16:9",
    "images": ["https://example.com/ref.jpg"],
    "reference_videos": ["https://example.com/motion.mp4"]
  }'

​
响应示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "task_id": "vid_abc123",
    "status": "queued",
    "model": "seedance2.0-mini",
    "created_at": 1710000000
  }
}

​
查询任务

curl -X GET 'https://www.jimmyai.cn/api/open-api/v1/videos/{task_id}' \
  -H 'Authorization: Bearer sk_xxx'
任务状态：queued → processing → completed / failed。完成后从 data.result.video_url 获取视频地址。
视频结果 URL 保存约 3 天，请及时转存。

授权

​
Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
​
model
string
必填

Model name. Manxue: sd2_mx_720p | sd2_mx_1080p | sd2_mx_2k | sd2_mx_4k; Fast: sd2_mx_fast_720p | sd2_mx_fast_1080p; Video ref: sd2_mx_video_720p | sd2_mx_video_1080p | sd2_mx_video_2k | sd2_mx_video_4k; Video ref Fast: sd2_mx_video_fast_720p | sd2_mx_video_fast_1080p (all per-second). reference_videos only for video-series models. SP economy: seedance2.0-sp | seedance2.0-fast-sp (per-second by resolution). SP official: seedance2.0-of-sp | seedance2.0-of-fast-sp (per-second by resolution). Mini: seedance2.0-mini (per-second by resolution). Mini Special: seedance2.0-mini-sp (per-task, 480p/720p only). MD: seedance2.0-md | seedance2.0-fast-md (per-task, 720p). Fast I2V: seedance2.0-fast-i2v (per-task, 720p, image refs only). STD standard: seedance2.0-std (per-task, 720p)

​
prompt
string
必填

Text prompt. MD route: max 5000 characters

​
duration
integer
必填

Duration in seconds. Full 4-12; SP economy 4-15; MD 1-15; STD standard 4-15. Default 5

​
resolution
enum<string>

Output resolution for SP economy. Default 720p

可用选项:
480p,
720p,
1080p
​
orientation
enum<string>

Video orientation (ratio takes precedence if set)

可用选项:
landscape,
portrait
​
images
string[]

Reference images. Full route: asset://{assetId}; SP/MD/STD/Fast I2V: https:// URL. MD max 4; seedance2.0-fast-i2v and STD max 9. Mutually exclusive with first_image/last_image

​
ratio
string

Aspect ratio. MD: 16:9, 9:16, 1:1 only. STD: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. Full route also supports 4:3, 3:4, 21:9, Adaptive

​
first_image
string

First frame. Full: asset://{assetId}; Economy/MD: https:// URL. MD frame mode requires last_image as well; first frame only is not supported

​
last_image
string

Last frame. Full: asset://{assetId}; Economy/MD: https:// URL. MD frame mode requires first_image as well

​
reference_videos
string[]

Reference videos. Full: asset://{assetId}; Economy/MD: https:// URL. MD: max 3, combined duration ≤15s, combined size ≤200MB, each resolution 720px–2160px. Not supported on seedance2.0-fast-i2v

​
reference_audios
string[]

Reference audio. Supported on Full, SP economy, and STD. Not supported on MD or seedance2.0-fast-i2v. Full: asset://{assetId}; SP: https:// URL or asset://. STD max 3 clips; frame mode does not support audio references

响应

200 - application/json

Task created successfully

​
code
string
示例:

"20000"

​
msg
string
示例:

"ok"

​
data
object