---
title: "Create video from text - Veo 3.1"
method: POST
path: "/v1/ai/text-to-video/veo-3-1"
tags: ["text-to-video"]
---

# Create video from text - Veo 3.1

`POST /v1/ai/text-to-video/veo-3-1`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/text-to-video/veo-3-1`
- Auth: API key in header `x-magnific-api-key`

Generate a video from text prompt using Google Veo 3.1 model. Supports multiple resolutions (720p, 1080p, 4K) and optional audio generation.

## Request body

- T2vRequest4
  - `webhook_url` string, uri: Webhook URL to notify when the task is completed
  - `prompt` string, required: Text prompt describing the video to generate
  - `negative_prompt` string: Text describing what to avoid in the generated video
  - `duration` 4 | 6 | 8: Duration of the generated video in seconds.
  - `resolution` '720p' | '1080p' | '4k': Resolution of the generated video.
  - `aspect_ratio` '16:9' | '9:16': Aspect ratio of the generated video. 16:9 for landscape, 9:16 for portrait.
  - `generate_audio` boolean: Whether to generate audio for the video
  - `seed` integer: Random seed for reproducibility

## Response `200`

OK - The task exists and the status is returned

- InlineObject4
  - `data` TaskDetail1, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status
    - `generated` string[], required

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)