API reference · Bytedance

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

Integrate this model through SandBase's unified API, with production-ready schemas and examples.

VIDEOAsyncOpen model

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDbytedance/seedance/2.0/mini/image-to-video

Input Schema

8 parameters · 2 required · 6 optional

Parameter	Type	Required	Description
`image`	string	Required	The URL of the starting frame image to animate. Supported formats: JPEG, PNG, WebP. Max 30 MB.
`prompt`	string	Required	The text prompt describing the desired motion and action for the video.
`duration`	integer	Optional	Duration of the video in seconds. Supports 4 to 15 seconds, or auto to let the model decide based on the prompt. · Options: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 · Default: "auto" 456789101112131415
`end_image`	string	Optional	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. Max 30 MB.
`resolution`	string	Optional	Video resolution - 480p for faster generation, 720p for balance. · Options: 480p, 720p · Default: "720p" 480p720p
`end_user_id`	string	Optional	The unique user ID of the end user.
`aspect_ratio`	string	Optional	The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16
`generate_audio`	boolean	Optional	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

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "bytedance/seedance/2.0/mini/image-to-video",
  "image": "https://v3b.fal.media/files/b/0a8eba37/Cqg-4Uwzyz4DELfceT1CF_a17e588773ec45b1a9e6f100a787b80b.jpg",
  "prompt": "An octopus finds a football in the ocean and excitedly calls its octopus friends to come and play. Cut scene to an octopus football game under the sea.",
  "duration": "auto",
  "resolution": "720p",
  "generate_audio": true
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Seedance 2.0 Mini Image to Video