Create Video (Text-to-Video)

POST

/v1/videos

Note: Video duration is determined by the model ID; e.g. choosing gemini-veo-3.1-generate-preview-6s yields a 6-second video.

Model IDs:

gemini-veo-3.1-generate-preview-4s

gemini-veo-3.1-generate-preview-6s

gemini-veo-3.1-generate-preview-8s

gemini-veo-3.1-generate-preview-ref-4s

gemini-veo-3.1-generate-preview-ref-6s

gemini-veo-3.1-generate-preview-ref-8s

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "model": "gemini-veo-3.1-generate-preview-ref-8s",
    "prompt": "A miniature city constructed from cardboard and bottle caps comes to life at night. A row of cardboard trains slowly passes by, with small lights scattered among them, illuminating the way ahead.",
    "size": "1280x720"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.aiide.com/v1/videos' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gemini-veo-3.1-generate-preview-ref-8s",
    "prompt": "A miniature city constructed from cardboard and bottle caps comes to life at night. A row of cardboard trains slowly passes by, with small lights scattered among them, illuminating the way ahead.",
    "size": "1280x720"
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "id": "string",
    "task_id": "string",
    "object": "string",
    "model": "string",
    "status": "string",
    "progress": 0,
    "created_at": 0
}

🟠429Rate Limit

🟠400Bad Request

Modified at 2026-09-10 06:20:07

Get Video Generation Task Status

Create Video (Reference-Image-to-Video)