Seedance 2.5 Image-to-Video

Seedance 2.5 Image-to-Video is a multimodal video generation tool based on reference images, supporting video editing and extension capabilities.

Base URL

https://api.icreat.ai

Authentication

All API requests must be authenticated with an API Key. You can obtain an API Key from the console.

export ICREAT_API_KEY="your-api-key-here"

HTTP Request Headers

import os

API_KEY = os.environ.get("ICREAT_API_KEY")
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer " + API_KEY,
}

Protect your API Key

Never expose your API Key in client-side code or public repositories. Use environment variables or a backend proxy.

Code Examples

Image and video generation uses a three-step async flow: submit to get task_id, poll status, then fetch results when status is SUCCEEDED.

1. Submit Task

Send a generation request to the submit endpoint.

POST/v1/task/submit/bytedance/seedance-2-5/image-to-video

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST https://api.icreat.ai/v1/task/submit/bytedance/seedance-2-5/image-to-video \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "content": [
    {
      "type": "text",
      "text": "A cat is playing with a ball"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/reference.jpg"
      },
      "role": "reference_image"
    }
  ],
  "generate_audio": true,
  "ratio": "3:4",
  "duration": 5,
  "resolution": "480p"
}'

2. Poll Status

Poll with task_id. Response contains only status.

POST/v1/task/query-status

curl --connect-timeout 10 --max-time 60 \
  -X POST "https://api.icreat.ai/v1/task/query-status" \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "task_id": "task-xxx"
}'

3. Get Result

Fetch output when the task succeeds.

POST/v1/task/get-result

curl --connect-timeout 10 --max-time 60 \
  -X POST "https://api.icreat.ai/v1/task/get-result" \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "task_id": "task-xxx"
}'

Input Schema

Submit Task — Input

Total: 8 Required: 2 Optional: 6

contentobject[]required

Multimodal content array containing the text prompt and reference images.

generate_audioboolean

Whether to generate audio.

ratiostring

Output video aspect ratio. Supported values: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, and adaptive. When set to adaptive, the model automatically selects a suitable aspect ratio based on the input.

resolutionstring

Output video resolution. Supported values: 480p and 720p.

durationinteger

Video duration in seconds. Supports integers from 4 to 30, or -1 to let the model automatically select the duration.

watermarkboolean

Whether to add an “AI Generated” watermark.

typestringrequired

Content type. Supported values: text and image_url.

need_reviewboolean

Whether to submit the reference image for official review. Set this to true when the reference image contains a face or copyrighted IP.

Poll Status — Input

Total: 1 Required: 1 Optional: 0

task_idstringrequired

Task ID from the submit endpoint.

Get Result — Input

Total: 1 Required: 1 Optional: 0

task_idstringrequired

Task ID from the submit endpoint.

Output Schema

Submit Task — Output

Total: 1

task_idstring

Async task identifier.

Poll Status — Output

Total: 1

statusstring

Current task status. Fetch results when SUCCEEDED.

Get Result — Output

Top-level array of resource objects.

Total: 3

typestring

Resource type; Video for this model.

urlstring

Preview/access URL.

download_urlstring

Download URL.

LLM Prompt

The Markdown below is an LLM-friendly prompt you can paste into AI assistants (e.g. Cursor, ChatGPT) to help them understand this model's API, call flow, and key parameters. Use Copy for AI or copy from the code block below.

# bytedance/seedance-2-5/image-to-video

> Seedance 2.5 Image-to-Video is a multimodal video generation tool based on reference images, supporting video editing and extension capabilities.

## Overview

Use the iCreat three-step async task API: submit a generation request, poll status, then fetch the video URL on success.

## API Info

- **Base URL**：`https://api.icreat.ai`
- **Submit endpoint (POST)**：`/v1/task/submit/bytedance/seedance-2-5/image-to-video`
- **Poll endpoint (POST)**：`/v1/task/query-status`
- **Get result endpoint (POST)**：`/v1/task/get-result`
- **Model ID**：`bytedance/seedance-2-5/image-to-video`
- **Auth**：`Authorization: Bearer ${ICREAT_API_KEY}`

## Call Flow

1. **Submit**: POST submit path with body per Input Notes; response `{ "task_id": "..." }`
2. **Poll**: POST `/v1/task/query-status` with `{ "task_id": "..." }`; response contains **only** `{ "status": "SUBMITTED|SUCCEEDED|FAILED" }`
3. **Get result**: when `status` is `SUCCEEDED`, POST `/v1/task/get-result`; top-level array; read `url` or `download_url` when `type` is `Video`

### Input Notes

- Request body centers on a multimodal `content` array plus resolution/duration params
- `generate_audio` (optional): Whether to generate audio.
- `ratio` (optional): Output video aspect ratio. Supported values: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, and `adaptive`. When set to `adaptive`, the model automatically selects a suitable aspect ratio based on the input.
- `resolution` (optional): Output video resolution. Supported values: `480p` and `720p`.
- `duration` (optional): Video duration in seconds. Supports integers from `4` to `30`, or `-1` to let the model automatically select the duration.
- `watermark` (optional): Whether to add an “AI Generated” watermark.
- `need_review` (optional): Whether to submit the reference image for official review. Set this to `true` when the reference image contains a face or copyrighted IP.

### Output Notes

- Poll: read `status` only
- Result: top-level `[{ "type": "Video", "url": "...", "download_url": "..." }]`

## Notes

- Use the same `task_id` across all three steps; do not skip polling
- `FAILED` is terminal — check request parameters or reference media