Query tasks(Vidu)

curl --request GET \
  --url https://api.aiid.edu.kg/ent/v2/tasks/{task_id}/creations \
  --header 'Authorization: Bearer <token>'

{
  "id": "<string>",
  "err_code": "<string>",
  "credits": 123,
  "payload": "<string>",
  "creations": [
    {
      "id": "<string>",
      "url": "<string>",
      "cover_url": "<string>",
      "watermarked_url": "<string>"
    }
  ],
  "task_id": "<string>"
}

Video generation Vidu

Query tasks(Vidu)

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

Vidu official video generation API; the public path follows the Vidu official specification.

Current public model: viduq3-turbo. Supports text-to-video, image-to-video, start-and-end-frame video generation, and reference-based video generation. The same model also supports access via the /v1/videos Sora compatible format. Common mode are t2v, i2v, i2v_first_last, and reference_images.

Provides the public request skeleton, task query structure, and recommended validation template for the Vidu official video generation format, while the public path retains the Vidu official endpoint format.

Supported models: viduq3-turbo

Unified request fields:

model (string, required): Vidu public model name, currently public viduq3-turbo.
prompt (string, optional): Video generation prompt; required for text-to-video, and passed as needed for image-to-video, start-and-end-frame, and reference-based video generation.
images (array[string], optional): Image input. 1 image for image-to-video, 2 images for start-and-end-frame video generation, and 1~7 images for reference-based video generation.
videos (array[string], optional): Optional video subject input for reference-based video generation, used according to the capabilities of the Vidu official model.
subjects (array[object], optional): Subject-library format input for reference-based video generation; may include fields such as subject name, image, video, or voice timbre.
duration (integer, optional): Video duration, in seconds. viduq3-turbo commonly uses 5 seconds; set it according to the official range.
resolution (string, optional): Output resolution, common values are 540p, 720p, and 1080p.
aspect_ratio (string, optional): Output aspect ratio, commonly used for text-to-video/reference-based video generation, such as 16:9, 9:16, and 1:1.
seed (integer, optional): Random seed.
movement_amplitude (string, optional): Motion intensity, common values are auto, small, medium, and large.
audio (boolean, optional): Whether to enable direct audio-video output.
off_peak (boolean, optional): Whether to use staggered generation.
watermark (boolean, optional): Whether to add a watermark.

Common model/mode differences:

Vidu 文生视频: Supported model viduq3-turbo; official-format text-to-video.
Vidu 图生视频: Supported model viduq3-turbo; official-format single-image image-to-video.
Vidu 首尾帧生视频: Supported model viduq3-turbo; official-format two-image start-and-end-frame video generation.
Vidu 参考生视频: Supported model viduq3-turbo; official-format multi-reference image-to-video.

GET

ent

tasks

{task_id}

creations

Query tasks(Vidu)

curl --request GET \
  --url https://api.aiid.edu.kg/ent/v2/tasks/{task_id}/creations \
  --header 'Authorization: Bearer <token>'

{
  "id": "<string>",
  "err_code": "<string>",
  "credits": 123,
  "payload": "<string>",
  "creations": [
    {
      "id": "<string>",
      "url": "<string>",
      "cover_url": "<string>",
      "watermarked_url": "<string>"
    }
  ],
  "task_id": "<string>"
}

Authorizations

Authorization

string

header

required

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

Path Parameters

task_id

string

required

Task ID, from the task_id returned when creating the task.

Response

200 - application/json

Query successful

string

Task ID.

state

enum<string>

Task status. Common values: created, queueing, processing, success, failed.

Available options:

created,

queueing,

processing,

success,

failed

err_code

string

credits

integer

Points consumed for this task.

payload

string

creations

object[]

Hide child attributes

creations.id

string

creations.url

string<uri>

The URL of the generated video after the task succeeds.

creations.cover_url

string<uri>

Cover URL after the task succeeds.

creations.watermarked_url

string<uri>

Watermarked video URL.

task_id

string

The task ID returned when creating a task, used to query the task.

Create a start-and-end frame video(Vidu)Create text-to-video (Vidu)