Video generation

POST

/gaga/v1/generations

This API can create tasks based on requirements and parameters, and return a task ID.
Using "a single portrait photo + text script (and audio)", it can quickly generate film-grade character performance videos with synchronized audio and visuals, realizing the integrated generation of voice, expressions, and movements. The API supports native-level lip-sync for five languages: Chinese, English, Japanese, Korean, and French. It can also accurately simulate accented performances, such as the effect of "a foreign character speaking broken Mandarin".

Usage Steps

Call the material upload API (/gaga/v1/assets) to upload the reference image and audio, and obtain the identification ID of the relevant materials.

Call the video generation API (/gaga/v1/generations) to obtain the task ID.

Call the task query API (/gaga/v1/generations/{id}), enter the obtained task ID, and you can get the generation result.

Pricing

Model Version	Resolution	Duration	Price (PTC)
gaga-1	720p	5s	0.15
gaga-1	720p	10s	0.3
gaga-1	1080p	5s	0.3
gaga-1	1080p	10s	0.6

Request

Header Params

Body Params application/jsonRequired

Example

{
  "model": "gaga-1",
  "resolution": "720p",
  "aspectRatio": "16:9",
  "source": {
    "type": "image",
    "content": 741241938615621
  },
  "chunks": [
    {
      "conditions": [
        {
          "type": "text",
          "content": "say hello"
        },
        {
          "type": "audio",
          "content": "741241298607429"
        }
      ],
      "duration": 5,
      "enablePromptEnhancement": true
    }
  ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/gaga/v1/generations' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "gaga-1",
  "resolution": "720p",
  "aspectRatio": "16:9",
  "source": {
    "type": "image",
    "content": 741241938615621
  },
  "chunks": [
    {
      "conditions": [
        {
          "type": "text",
          "content": "say hello"
        },
        {
          "type": "audio",
          "content": "741241298607429"
        }
      ],
      "duration": 5,
      "enablePromptEnhancement": true
    }
  ]
}'

Responses

🟢200success

application/json

Body

Example

{
    "id": 741241995808005
}

Modified at 2025-11-28 02:12:09

vidu/start-end-to-video-q2-turbo

Query