bytedance/seedance-2-5/text-to-video

1. Authentication

The API uses an API key for authentication.

Get Your API Key

Get your API key from https://icreat.ai/hub/keys.

2. Call the API

Submit a Request

Use cURL to submit an HTTP request and start a task:

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST https://api.icreat.ai/v1/task/submit/bytedance/seedance-2-5/text-to-vide \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "content": [
    {
      "type": "text",
      "text": "A golden retriever running on a beach at sunset in slow motion"
    }
  ],
  "ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

The server will return a response body similar to the following:

{ "task_id" : "task-xxx"}

Use the task_id to poll the task status and retrieve the result.

3. Poll the Task 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"
}'

The server will return the task status. When the status is SUCCEEDED, you can retrieve the result.

4. Retrieve the 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"
}'

The server will return the output of the task.

5. Schema

Top-Level

The API uses a multimodal input structure. content is a required array that supports any combination of text, image, video, and audio references.

Field	Type	Required	Description
`content`	object[]	Yes	Multimodal content array. See the schema below.
`generate_audio`	boolean	No	Whether to generate audio
`ratio`	string	No	Output 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 the most suitable aspect ratio based on the input.
`resolution`	string	No	Output resolution. Supported values: `480p` and `720p`
`duration`	integer	No	Video duration in seconds. Accepts integers from `4` to `30`, or `-1` to let the model automatically select the duration.
`watermark`	boolean	No	Whether to add an “AI Generated” watermark
`tools`	object[]	No	List of tools to use

`content[]` Items

Field	Type	Required	Description
`type`	string	Yes	Content type: `text`, `image_url`, `video_url`, or `audio_url`
`text`	string	Conditionally required	Required when `type=text`. Supports Chinese, English, Japanese, Indonesian, Spanish, and Portuguese.

`tools[]` Items

Field	Type	Required	Description
`type`	string	Yes	Tool type. Currently, only `web_search` is supported.

6. Input Examples

6.1 Text-to-Video

{
  "content": [
    {
      "type": "text",
      "text": "A cat is playing a ball"
    }
  ],
  "generate_audio": true,
  "ratio": "3:4",
  "duration": 5,
  "resolution": "480p"
}

6.2 Without a Watermark

{
  "content": [
    {
      "type": "text",
      "text": "A cat is playing a ball"
    }
  ],
  "generate_audio": true,
  "ratio": "3:4",
  "duration": 5,
  "resolution": "480p",
  "watermark": false
}