Skip to main content
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
  }
}
Create a Seedance STD video task. On success you receive a task_id. Poll Query Video Task until completed, then read the video URL from result.video_url.
This endpoint is shared with Create Seedance Full Video: POST /api/open-api/v1/seedance/videos. Use model: "seedance2.0-std" to select the standard route.

Model

Routemodel valueBillingDurationOutput
STD standardseedance2.0-stdPer task4–15 sFixed 720p

Request fields

FieldTypeRequiredDescription
modelstringYesUse seedance2.0-std
promptstringYesText prompt
durationintYesLength in seconds, 4–15 (default 5)
ratiostringNo16:9 (default), 9:16, 1:1, 4:3, 3:4, or 21:9
imagesstring[]NoReference images, max 9
first_imagestringNoFirst frame
last_imagestringNoLast frame
reference_videosstring[]NoReference videos
reference_audiosstring[]NoReference audio clips, max 3
The resolution field is ignored. STD output is always 720p.

Assets

  • Pass publicly reachable https:// image, video, or audio URLs directly.
  • reference_videos only accepts video URLs. Put image URLs in images.
  • SP asset library (asset://) and Full-route audit flows do not apply to STD.

Constraints

  • Do not combine images (reference image mode) with first_image / last_image (frame mode).
  • Frame mode accepts first_image, last_image, or both.
  • Frame mode does not support reference_audios.
  • ratio must be one of 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.
  • At most 9 items in images.
  • At most 3 items in reference_audios.
  • reference_videos only supports video URLs, not image URLs.

Examples

Reference images

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-std",
    "prompt": "A subject walks through city streets in morning light, steady tracking shot, cinematic lighting",
    "duration": 8,
    "ratio": "16:9",
    "images": [
      "https://example.com/ref-1.jpg",
      "https://example.com/ref-2.jpg"
    ]
  }'

Video and audio references

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-std",
    "prompt": "Use the motion rhythm from the reference video to create a music-driven product showcase",
    "duration": 10,
    "ratio": "9:16",
    "reference_videos": [
      "https://example.com/motion.mp4"
    ],
    "reference_audios": [
      "https://example.com/music.mp3"
    ]
  }'

First and last frame image-to-video

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-std",
    "prompt": "Smooth transition from an indoor window scene to a rooftop city night, slow dolly in",
    "duration": 6,
    "ratio": "21:9",
    "first_image": "https://example.com/start.png",
    "last_image": "https://example.com/end.png"
  }'

Response

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

Poll for result

curl -X GET 'https://www.jimmyai.cn/api/open-api/v1/videos/{task_id}' \
  -H 'Authorization: Bearer sk_xxx'
Statuses: queuedprocessingcompleted or failed. Video URL is in data.result.video_url when completed.
Result URLs are retained for about 3 days. Download promptly.

Authorizations

Authorization
string
header
required

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

Body

application/json
model
string
required

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
required

Text prompt. MD route: max 5000 characters

duration
integer
required

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

Available options:
480p,
720p,
1080p
orientation
enum<string>

Video orientation (ratio takes precedence if set)

Available options:
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

Response

200 - application/json

Task created successfully

code
string
Example:

"20000"

msg
string
Example:

"ok"

data
object