Model API

Seedance 2 (US)

US hosted version of ByteDance's most advanced image-to-video model. Animate still images into cinematic video with synchronized audio, start and end frame control, and motion prompts.

Model id

Use this in every request

bytedance/seedance-2.0/us/image-to-video

This model has other modes with their own ids: bytedance/seedance-2.0/us/text-to-video, bytedance/seedance-2.0/us/reference-to-video.

Run it

Quote the input, start the generation with the quote, then poll the job. Set RAYWAKE_API_KEY first; see Authentication.

# 1. Price the exact input (quotes are valid for up to 10 minutes)
curl -s https://api.raywake.com/v1/quotes \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedance-2.0/us/image-to-video",
  "input": {
    "prompt": "A red ceramic cup on a wooden table, soft morning light",
    "image_url": "https://example.com/input.png"
  }
}'

# 2. Start the generation with the quote_id from step 1
curl -s https://api.raywake.com/v1/generate \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "bytedance/seedance-2.0/us/image-to-video", "quote_id": "QUOTE_ID", "input": {"prompt":"A red ceramic cup on a wooden table, soft morning light","image_url":"https://example.com/input.png"}}'

# 3. Poll until the status is terminal
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"

Input

Input fields for bytedance/seedance-2.0/us/image-to-video
Name	Type	Description
`prompt`required	string	The text prompt describing the desired motion and action for the video.
`image_url`required	string (image URL)	The URL of the starting frame image to animate. Supported formats: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB.
`end_image_url`	string (image URL)	The URL of the image to use as the last frame of the video. When provided, the generated video will transition from the starting image to this ending image. Supported formats: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB.
`resolution`	string (enum)	Video resolution - 480p for faster generation, 720p for balance, 1080p for high quality, 4k for highest quality. Default: `720p` One of: `480p`, `720p`
`duration`	string (enum)	Duration of the video in seconds. Supports 4 to 15 seconds, or auto to let the model decide based on the prompt. Default: `5` One of: `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`
`aspect_ratio`	string (enum)	The aspect ratio of the generated video. Use 16:9 for landscape, 9:16 for portrait/vertical, 1:1 for square, 21:9 for ultrawide cinematic, or auto to infer from the input image. Default: `16:9` One of: `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`
`generate_audio`	boolean	Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not. Default: `true`
`bitrate_mode`	string (enum)	Output bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate. Default: `standard` One of: `standard`
`codec`	string (enum)	'auto' retains default video codec behaviour; 'H264' uses H.264; 'H265' uses H.265. Default: `auto` One of: `auto`
`end_user_id`	string	The unique user ID of the end user.

Output

A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.

Job excerpt

"outputs": [
  { "type": "video", "url": "https://…", "mime_type": "video/mp4", "thumbnail_url": "https://…" }
]

Pricing

480p · 5 s · up to$1.16/ run
720p · 5 s · up to$2.49/ run

The exact charge for your input comes from a quote. How charges settle