Veo Video Overview
The Veo video is suitable for high-quality text-to-video, image-to-video and reference media assets videos. MoonNexAI organizes the Veo scene into the video task process, then creates task and then asks for the final results through task ID.
Current Model
The Veo model name is based on the MoonNexAI console, the model list API and the API Reference. It is recommended to call GET /v1/models to confirm the available model before access.
Current API Behaviour
| Item | Current behaviour |
|---|---|
| Create task | Use POST /v1/videos. |
| Query task | Use GET /v1/tasks/{task_id} or GET /v1/videos/{task_id}. |
| Input | Text prompts are supported. Image-to-video can accept image URLs or asset references as specified by the model. |
| Callback | Pass callback_url during creation to receive a completion callback. |
API Path
| Methodology | Path | Purpose |
|---|---|---|
POST | /v1/videos | Creates a Veo video task. |
GET | /v1/tasks/{task_id} | Query task centre state. |
GET | /v1/videos/{task_id} | Query video task results. |
Common field
| field | Annotations |
|---|---|
model | Veo Model Name, based on the Model List and API Reference. |
prompt | Video description, with recommendations for subject, action, lens, light and style. |
duration / seconds | Video duration. |
aspect_ratio / ratio | Video aspect ratio. |
image / image_url | image-to-video or reference images input. |
callback_url | task addresses after completion of callback. |
Example request
bash
curl https://moonnexai.com/v1/videos \
-H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"model": "veo-model",
"prompt": "A product reveal video with smooth camera movement and natural studio lighting.",
"duration": 5,
"aspect_ratio": "16:9"
}'task Processing
| Phase | Treatment |
|---|---|
| Successful submission | Saves id or task_id, model name, prompt and business orders. |
| Generating | polling query API, or wait for callback_url callback. |
| Completed | Reads the video URL and saves the full query result. |
| Failed | Saves error information and original request body, which allows users to retry. |