Seedance 2.5 Flash Image to Video API
seedance-2.5-flash/image-to-videoSeedance 2.5 Flash Image to Video animates a start frame, or start and end frames, into 4–30 second videos with synchronized audio at 480p or 720p. It keeps the subject, composition, and lighting of your first image while adding prompt-directed motion.
Input
Drag and drop files, paste from clipboard, or provide a URL. JPEG, PNG, or WebP, up to 30 MB
1/1 files added
Drag and drop files, paste from clipboard, or provide a URL. JPEG, PNG, or WebP, up to 30 MB
1/1 files added
Output
ReadyContinue with
REST API
Quick Start
Authenticate, submit a valid input object, then use task_id to retrieve the video.
Connect to the Vidgo API
Create an API key, keep it only on your server, and send Authorization: Bearer VIDGO_API_KEY.
- Endpoint
- POST
https://api.vidgo.ai/api/generate/submit - Authentication
- Authorization: Bearer VIDGO_API_KEY
Submit one generation task
Run the smallest valid payload for this workflow. A successful submission immediately returns task_id without waiting for the video.
REQUEST_BODY=$(cat <<'JSON'
{
"model": "seedance-2.5-flash/image-to-video",
"input": {
"prompt": "Begin from Image 1, push in slowly as the subject turns toward the window, and finish on Image 2.",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/start-frame.png",
"https://example.com/end-frame.png"
],
"generate_audio": true
}
}
JSON
)
RESPONSE=$(curl --silent --show-error --fail-with-body \
--request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data "$REQUEST_BODY")
CODE=$(printf '%s' "$RESPONSE" | jq -r '.code // empty')
if [ "$CODE" != "0" ] && [ "$CODE" != "200" ]; then
printf 'API error: %s
' "$RESPONSE" >&2
exit 1
fi
printf '%s
' "$RESPONSE"Wait for the result
Query with task_id, continue for not_started/running, and stop for finished/failed. On success, read data.files[].file_url.
Track status
GET https://api.vidgo.ai/api/generate/status/{task_id}Poll about every 2 seconds, then back off gradually. Continue only for not_started or running and stop on finished or failed. You can instead add callback_url to the same top-level request contract.
not_startedrunningfinishedfailed{
"code": 200,
"data": {
"task_id": "task-unified-...",
"status": "running",
"created_time": "2026-08-22T10:00:00Z"
}
}{
"code": 200,
"data": {
"task_id": "task-unified-...",
"status": "finished",
"files": [
{
"file_url": "https://storage.vidgo.ai/generated/video.mp4",
"file_type": "video"
}
],
"created_time": "2026-08-22T10:00:00Z",
"progress": 100,
"error_message": null
}
}Complete runnable example
Expand for a complete script with HTTP and business-code checks, task_id validation, polling, terminal-state handling, and a timeout boundary.
set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"
REQUEST_BODY=$(cat <<'JSON'
{
"model": "seedance-2.5-flash/image-to-video",
"input": {
"prompt": "Begin from Image 1, push in slowly as the subject turns toward the window, and finish on Image 2.",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/start-frame.png",
"https://example.com/end-frame.png"
],
"generate_audio": true
}
}
JSON
)
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
--request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data "$REQUEST_BODY")
TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
BUSINESS_CODE=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.code // empty')
if [ "$BUSINESS_CODE" != "0" ] && [ "$BUSINESS_CODE" != "200" ]; then
printf 'Submit failed:
%s
' "$SUBMIT_RESPONSE" >&2
exit 1
fi
if [ -z "$TASK_ID" ]; then
printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
exit 1
fi
START_TIME=$(date +%s)
POLL_DELAY=2
while true; do
if [ $(( $(date +%s) - START_TIME )) -ge 600 ]; then
printf 'Timed out after 600 seconds
' >&2
exit 1
fi
STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
--url "https://api.vidgo.ai/api/generate/status/$TASK_ID" \
--header "Authorization: Bearer $VIDGO_API_KEY")
STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')
BUSINESS_CODE=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.code // empty')
if [ "$BUSINESS_CODE" != "0" ] && [ "$BUSINESS_CODE" != "200" ]; then
printf 'Status request failed:
%s
' "$STATUS_RESPONSE" >&2
exit 1
fi
case "$STATUS" in
finished)
printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
break
;;
failed)
printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
exit 1
;;
not_started|running)
sleep "$POLL_DELAY"
if [ "$POLL_DELAY" -lt 10 ]; then POLL_DELAY=$((POLL_DELAY + 1)); fi
;;
*)
printf 'Unexpected task status: %s
' "$STATUS" >&2
exit 1
;;
esac
doneInput parameters
These are the fields accepted inside input. The request example shows the required top-level model field.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| prompt | string | Yes | — | Text prompt describing the video. |
| duration | integer | Yes | — | An integer from 4 through 30, inclusive. |
| image_urls | string[] | Yes | — | 1–2 public image URLs: the start frame and an optional end frame. |
| resolution | string | No | 720p | 480p or 720p. |
| aspect_ratio | string | No | — | auto; framing follows the start frame. |
| generate_audio | boolean | No | — | Whether to generate synchronized audio; the rate is the same either way. |
Response Fields
Submission returns task identity immediately. Status responses add progress, every output file, or a failure message.
| Field | Type | Description |
|---|---|---|
| code | integer | Application result code; successful responses use 0 or 200. |
| message | string | Human-readable message or error detail when present. |
| data.task_id | string | Task ID used in the status endpoint path. |
| data.status | string | not_started, running, finished, or failed. |
| data.created_time | string | Task creation time in date-time format. |
| data.progress | integer | 0–100 progress when reported by the provider. |
| data.files[] | array | All output files from a successful task, in response order. |
| data.files[].file_url | string | Public URL for a generated video. |
| data.files[].file_type | string | File type, such as video. |
| data.error_message | string | null | Failure detail when status is failed. |
Task Lifecycle
Treat not_started and running as non-terminal states. finished and failed are terminal alternatives; stop polling when either is returned.
not_startedThe task was accepted and is waiting to begin.
runningGeneration is in progress. Continue polling the same task_id.
finishedGeneration succeeded. Read every video URL from data.files[].file_url.
failedGeneration stopped with an error. Read data.error_message and stop polling.
Polling and Errors
- AuthenticationA 401 response means the Bearer API key is missing or invalid. Correct it before retrying.
- ValidationA 400 response identifies an invalid field, unsupported media key, or insufficient credit balance. Correct the request before resubmitting.
- Network and timeoutA transport failure is different from a failed task. Retry status checks with a bounded timeout before deciding that the task failed.
- Polling intervalStart around every 2 seconds and increase the interval gradually for a long-running task.
- Terminal statesContinue only for not_started or running. Stop immediately on finished or failed.
- Callback optionProvide callback_url at the request top level to receive the final flat task object; polling remains available if delivery fails.
Endpoint limits
| Specification | Value | Details |
|---|---|---|
| Input mode | Start frame + optional end frame | Item 1 of image_urls is the start frame; item 2 is the end frame. |
| Output | Video task | The endpoint returns an asynchronous task ID; the video can include synchronized audio. |
| Resolution | 480p / 720p | Defaults to 720p. |
| Duration | 4–30 seconds | Every whole-second value in the inclusive range. |
| Aspect ratio | auto | Follows the start frame. |
| Billing basis | Output seconds | 480p uses 18.5 credits/s; 720p uses 41 credits/s. |
Related Models
Seedance 2.5 Flash Image to Video API frequently asked questions
What is the Seedance 2.5 Flash Image to Video API?
Seedance 2.5 Flash Image to Video is a ByteDance Seed model for generating video from images. It animates a start frame, or a start and end frame, into 4–30 second clips at 480p or 720p with optional synchronized audio, at about a third less per second than Seedance 2.5. Built on the Seedance 2.5 audio-video workflow, it keeps the subject, composition, and lighting of the first frame while adding motion directed by your prompt. You can call it programmatically or try it from the playground above.
Does Seedance 2.5 Flash Image to Video support an end frame?
Yes. Send two URLs in image_urls: item 1 is the start frame and item 2 is the end frame. The video opens on the first image and finishes on the second, which suits transitions between two poses, layouts, or product angles. Keep both frames similar in camera angle and lighting for a smooth result.
How does Seedance 2.5 Flash Image to Video set the aspect ratio?
Framing follows the start frame. Send aspect_ratio as auto or leave it out, and crop the first image to the ratio you want before uploading, such as 9:16 for vertical video or 16:9 for widescreen.
How do I keep the subject consistent in Seedance 2.5 Flash Image to Video?
Use a clear start frame and name what should stay the same in the prompt, such as the face, hairstyle, outfit, product label, and lighting. Describe one main action and one camera move, and add an end frame when the final pose matters.
How many credits per second does Seedance 2.5 Flash Image to Video use?
480p uses 18.5 credits per output second ($0.0925) and 720p uses 41 ($0.205). A 5-second 720p clip costs 205 credits, and the same rate covers an end frame and generated audio.
Can Seedance 2.5 Flash Image to Video add synchronized sound?
Yes. Set generate_audio to true to generate sound with the motion, such as footsteps, fabric, room tone, or speech. Name the sounds you want in the prompt. Setting it to false returns a silent video at the same price.
How does Seedance 2.5 Flash Image to Video compare with Seedance 2.5 Image to Video?
Both use the same start and end frame inputs and generate 4–30 second clips. Flash outputs 480p or 720p at 18.5 and 41 credits per second, while Seedance 2.5 Image to Video costs 28 and 63 credits per second and adds 1080p. Switch the model ID when a shot needs 1080p.
When should I use Seedance 2.5 Flash Reference to Video instead of Image to Video?
Choose Seedance 2.5 Flash Reference to Video when images should guide identity or style throughout the scene, or when you also want reference videos or audio for motion and sound. Use Image to Video when the first frame of the video is already decided.















