Vidu Q3

What this model is for

Use this page after trying Vidu Q3 in the APIXO playground. It shows the model ID, request body, result format, and the shared async workflow links you need for API integration.

Model ID, endpoint, and auth

Model ID: vidu-q3
Base URL: https://api.apixo.ai/api/v1

Method	Endpoint	Description
POST	`/api/v1/generateTask/vidu-q3`	Create a generation task
GET	`/api/v1/statusTask/vidu-q3`	Query task status

Authentication

All requests must include your API key in the request headers:

Authorization: Bearer YOUR_API_KEY

Request Body

{
  "request_type": "async",
  "callback_url": "https://...",
  "provider": "auto",
  "input": {
    "mode": "text-to-video",
    "prompt": "a cinematic shot of a futuristic city at sunrise",
    "resolution": "720p",
    "duration": 8,
    "style": "general",
    "aspect_ratio": "4:3",
    "movement": "auto",
    "sound": true,
    "bgm": true,
    "seed": 1234
  }
}

Parameters

request_type

string

default:"async"

Execution mode: async (polling) or callback

callback_url

string

Callback URL. Required when request_type=callback. (conditional)

provider

string

default:"auto"

Routing strategy: auto, value, official, or a specific provider channel

input

object

required

Model input parameters

Show properties

mode

string

required

text-to-video / image-to-video / turbo-text-to-video / turbo-image-to-video (image modes support 1 or 2 images via image_urls)

prompt

string

required

Text prompt, 1-5000 characters

resolution

string

required

Output resolution: 540p, 720p, or 1080p

duration

integer

required

Video duration in seconds, from 1 to 16. Billing is charged per second.

style

string

Style preset for text modes only: general or anime

aspect_ratio

string

default:"4:3"

Aspect ratio for text modes only: 16:9, 9:16, 4:3, 3:4, or 1:1

image_urls

string[]

Reference image URLs. Required for image modes. Up to 2 images are supported: 1 image for single-image animation, 2 images for first-and-last-frame generation. (conditional)

movement

string

Motion strength: auto, small, medium, or large

sound

boolean

default:"true"

Whether to generate sound effects (maps to the upstream generate_audio capability)

bgm

boolean

default:"true"

Whether to generate background music

seed

integer

Random seed, from -1 to 2147483647

Mode Reference:

text-to-video - Generate a video from text only
image-to-video - Generate a video from 1 or 2 images
turbo-text-to-video - Turbo text-to-video mode
turbo-image-to-video - Turbo image-to-video mode with 1 or 2 images

Copy-paste quickstart

Text-to-video (text-to-video)

curl -X POST "https://api.apixo.ai/api/v1/generateTask/vidu-q3" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "input": {
      "mode": "text-to-video",
      "prompt": "a cinematic flyover of a futuristic city at sunrise",
      "resolution": "720p",
      "duration": 8,
      "style": "general",
      "aspect_ratio": "16:9",
      "movement": "auto",
      "sound": true,
      "bgm": true
    }
  }'

Single-image animation (image-to-video, 1 image)

curl -X POST "https://api.apixo.ai/api/v1/generateTask/vidu-q3" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "callback",
    "callback_url": "https://your-server.com/callback",
    "input": {
      "mode": "image-to-video",
      "prompt": "make this image come alive with subtle motion",
      "resolution": "1080p",
      "duration": 4,
      "image_urls": [
        "https://example.com/start.jpg"
      ]
    }
  }'

First-and-last-frame generation (image-to-video, 2 images)

curl -X POST "https://api.apixo.ai/api/v1/generateTask/vidu-q3" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "input": {
      "mode": "image-to-video",
      "prompt": "transition from start to end smoothly",
      "resolution": "720p",
      "duration": 8,
      "image_urls": [
        "https://example.com/start.jpg",
        "https://example.com/end.jpg"
      ]
    }
  }'

Response and result format

POST /api/v1/generateTask/vidu-q3

On success, the API returns a taskId that you can use to query task status later. Success:

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_12345678"
  }
}

Failure:

{
  "code": 400,
  "message": "Insufficient credits",
  "data": null
}

GET /api/v1/statusTask/vidu-q3

Use taskId to query the execution status and final result.

curl -X GET "https://api.apixo.ai/api/v1/statusTask/vidu-q3?taskId=task_12345678" \
  -H "Authorization: Bearer YOUR_API_KEY"

Success:

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_12345678",
    "state": "success",
    "resultJson": "{\"resultUrls\":[\"https://r2.apixo.ai/video.mp4\"]}",
    "createTime": 1767965610929,
    "completeTime": 1767965730929,
    "costTime": 120000
  }
}

Failure:

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_12345678",
    "state": "failed",
    "failCode": "CONTENT_VIOLATION",
    "failMsg": "Content does not meet safety guidelines"
  }
}

Polling result fields

taskId

string

Unique task identifier.

state

string

Current task state: pending, processing, success, or failed.

resultJson

string

JSON string containing resultUrls array. Only present on success. Parse with JSON.parse().

failCode

string

Error code. Only present when state is failed. See Error Codes.

failMsg

string

Human-readable error message. Only present when state is failed.

createTime

integer

Task creation timestamp (Unix milliseconds).

completeTime

integer

Task completion timestamp (Unix milliseconds).

costTime

integer

Processing duration in milliseconds.

Polling and webhook result retrieval

Use request_type: "async" with the status endpoint when your app wants to poll for completion. Use request_type: "callback" with callback_url when your production service should receive the final result automatically. See Webhooks for delivery details.

Common errors

Code	Description
400	Invalid parameters or malformed request
401	Missing or invalid API key
402	Insufficient balance
429	Rate limit exceeded

Fail Code	Description
`CONTENT_VIOLATION`	The request violates safety guidelines
`INVALID_IMAGE_URL`	The provided image URL could not be fetched

Rate Limits

Limit	Value
Request rate	60 requests per minute
Concurrent tasks	10

If you exceed the limit, the API returns a 429 error. Retry later.

Video generation takes longer than images — use callback mode for production workloads. Result URLs expire after 15 days; download important outputs promptly.

Tips

Image count by mode: For image-to-video and turbo-image-to-video, the number of image_urls determines the workflow. 1 image creates a single-image animation. 2 images create a first-and-last-frame transition, where the first image is the start frame and the second image is the end frame.
Billing: Charges are calculated per second, and billed seconds are equal to duration. For pricing by resolution, see Pricing.
Polling recommendation: After submitting a task, wait about 60-90 seconds before polling, then poll every 5 seconds. For higher concurrency, prefer callback mode.
Result URL lifetime: Output URLs may expire. Download and store results as soon as possible.

Getting Started

Image Models

Video Models

Audio Models

What this model is for

Model ID, endpoint, and auth

Authentication

Request Body

Parameters

Copy-paste quickstart

Response and result format

POST /api/v1/generateTask/vidu-q3

GET /api/v1/statusTask/vidu-q3

Polling result fields

Polling and webhook result retrieval

Common errors

Rate Limits

Tips

Getting Started

Image Models

Video Models

Audio Models

Documentation Index

​What this model is for

​Model ID, endpoint, and auth

​Authentication

​Request Body

​Parameters

​Copy-paste quickstart

​Response and result format

​POST /api/v1/generateTask/vidu-q3

​GET /api/v1/statusTask/vidu-q3

​Polling result fields

​Polling and webhook result retrieval

​Common errors

​Rate Limits

​Tips

​Related links

What this model is for

Model ID, endpoint, and auth

Authentication

Request Body

Parameters

Copy-paste quickstart

Response and result format

POST /api/v1/generateTask/vidu-q3

GET /api/v1/statusTask/vidu-q3

Polling result fields

Polling and webhook result retrieval

Common errors

Rate Limits

Tips

Related links