curl --request POST \
  --url https://api.aiid.edu.kg/api/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-1-0-lite-i2v-250428",
  "mode": "reference_material",
  "prompt": "测试文字",
  "content": [
    {
      "type": "text",
      "text": "测试文字"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://imageproxy.zhongzhuan.chat/api/proxy/image/9979f1a754b3571d5e8bdcc397eedf53.png"
      },
      "role": "reference_image",
      "name": "1"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://imageproxy.zhongzhuan.chat/api/proxy/video/1979f1a754b3571d5e8bdcc397eedf53.mp4"
      },
      "role": "reference_video",
      "name": "2"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://imageproxy.zhongzhuan.chat/api/proxy/video/3979f1a754b3571d5e8bdcc397eedf53.mp3"
      },
      "role": "reference_audio",
      "name": "3"
    }
  ],
  "duration": 5,
  "size": "1280x720"
}
'

{
  "id": "task_xxx",
  "created_at": "<string>",
  "items": "<string>"
}

Video generation Seedance

Create video (Seedance)

This series supports OpenAI video generation formats (see the link Video generation Sora compatible formats).

Used to create video generation tasks and query status and results via task ID.

Core fields for task creation:

model: Required. Model name.
prompt: Required. Primary description for video generation.
content: Optional, the Volcano Ark content array, mixing text, image, video, and audio materials.
function_mode: Optional. Commonly used for advanced modes such as Omni-Reference.

Compatible input parameters:

mode：t2v / i2v / i2v_first_last / reference_images / reference_material
image_url / image_urls / input_reference
end_image_url / last_image_url
video_urls / audio_urls
seconds / duration
aspect_ratio / ratio / size
quality / resolution
fps
generate_audio / watermark

Call details:

When using mode=reference_material or function_mode=omni_reference, it is recommended to pass text and reference materials via content.
content text items are written as { "type": "text", "text": "测试文字" }.
content image, video, and audio material items use the image_url, video_url, and audio_url object formats respectively, for example { "type": "image_url", "image_url": { "url": "https://example.com/ref.png" }, "role": "reference_image", "name": "1" }.
role can be used to identify the purpose of the material, and name can be referenced by name in prompts.
ratio, duration, resolution, and fps will affect the final generation configuration.

Gemini Omni invocation:

gemini-omni can also be invoked through this Seedance task API.
mode=t2v is used for text-to-video, mode=r2v for generation with reference images/reference materials, and mode=edit for video editing.
Text can be placed in the text item of prompt or content; images can be placed in image_url / image_urls / reference_images / input_reference / content; videos can be placed in video_urls / content.
The duration field can use duration or seconds, and will be automatically mapped to the 4 / 6 / 8 / 10 second options.

Key fields in query results:

items[].status
items[].content.video_url or items[].video_url
items[].error
items[].progress

Error fields: error.code, error.message.

{
"error": {
"code": "invalid_request_error",
"message": "requires at least one image in `images`"
}
}

POST

api

contents

generations

tasks

curl --request POST \
  --url https://api.aiid.edu.kg/api/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-1-0-lite-i2v-250428",
  "mode": "reference_material",
  "prompt": "测试文字",
  "content": [
    {
      "type": "text",
      "text": "测试文字"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://imageproxy.zhongzhuan.chat/api/proxy/image/9979f1a754b3571d5e8bdcc397eedf53.png"
      },
      "role": "reference_image",
      "name": "1"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://imageproxy.zhongzhuan.chat/api/proxy/video/1979f1a754b3571d5e8bdcc397eedf53.mp4"
      },
      "role": "reference_video",
      "name": "2"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://imageproxy.zhongzhuan.chat/api/proxy/video/3979f1a754b3571d5e8bdcc397eedf53.mp3"
      },
      "role": "reference_audio",
      "name": "3"
    }
  ],
  "duration": 5,
  "size": "1280x720"
}
'

{
  "id": "task_xxx",
  "created_at": "<string>",
  "items": "<string>"
}

Authorizations

Authorization

string

header

required

Use Bearer Token authentication. Format: Authorization: Bearer sk-xxxxxx

Body

application/json

model

enum<string>

required

Required. Model name. You can pass the external-facing Seedance model, or gemini-omni.

Available options:

doubao-seedance-1-0-lite-i2v-250428,

doubao-seedance-1-0-lite-t2v-250428,

doubao-seedance-1-0-pro-250528,

doubao-seedance-1-0-pro-fast-251015,

doubao-seedance-1-5-pro-251215,

doubao-seedance-2-0-260128,

doubao-seedance-2-0-fast-260128,

gemini-omni

Example:

"doubao-seedance-2-0-260128"

prompt

string

required

Required. The primary description for video generation; cannot be empty.

Example:

"参考素材生成一段剧情短视频"

content

object[]

Optional. The Volcano Ark content array, which interleaves text and media items in order. Text items use { "type": "text", "text": "..." }; image, video, and audio items use image_url, video_url, and audio_url objects respectively, with url placed inside them. These can be used together with role (such as reference_image, reference_video, and reference_audio) and name for text references.

Hide child attributes

content.type

enum<string>

required

Content item type.

Available options:

text,

image_url,

video_url,

audio_url

content.text

string

Text content, used only when type=text.

content.image_url

Image URL. Recommended object format: {"url":"https://..."}.

content.video_url

Video URL. Recommended object syntax: {"url":"https://..."}.

content.audio_url

Audio URL. Recommended object format: {"url":"https://..."}.

content.role

string

Asset usage identifier. Common values include reference_image, reference_video, and reference_audio.

content.name

string

Asset name, can be referenced in text prompts or used to distinguish between multiple assets.

function_mode

string

Optional. Advanced feature mode, such as omni_reference for all-in-one reference.

mode

string

Optional. Compatibility mode fields, such as t2v, i2v, i2v_first_last, reference_images, and reference_material; gemini-omni supports t2v, r2v, and edit.

image_url

string

Optional. URL of a single reference image.

image_urls

string[]

Optional. A list of URLs for multiple reference images.

input_reference

string

Optional. Compatible with reference input fields.

end_image_url

string

Optional. The URL of the last-frame reference image.

last_image_url

string

Optional. URL alias for the last frame reference image.

video_urls

string[]

Optional. List of reference video URLs.

audio_urls

string[]

Optional. List of reference audio URLs.

seconds

Optional. Video duration in seconds; compatible with duration.

duration

Optional. Video duration in seconds; compatible with seconds.

aspect_ratio

string

Optional. Aspect ratio, such as 16:9.

ratio

string

Optional. Aspect ratio aliases, such as 16:9.

size

string

Optional. Field for resolution or dimension compatibility.

quality

string

Optional. Generation quality configuration.

resolution

string

Optional. The output resolution.

fps

number

Optional. Frame rate.

generate_audio

boolean

Optional. Whether to generate audio.

watermark

boolean

Optional. Whether to add a watermark.

Response

200 - application/json

Task created successfully

string

required

Task ID.

Example:

"task_xxx"

status

enum<string>

Task status.

Available options:

queued,

running,

succeeded,

failed

created_at

string

Creation time (Unix seconds).

items

string

Query tasks (Omni and Veo formats)Query task (Seedance)