> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magnific.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Veo 3.1 – Text-to-Video API | Magnific API

> Generate cinematic videos from text prompts with Google Veo 3.1. Supports 720p, 1080p, and 4K resolutions with optional audio. Standard and Fast modes available.

<Card title="Google Veo 3.1" icon="google">
  State-of-the-art text-to-video generation powered by Google's Veo 3.1 model with multi-resolution output and optional audio synthesis.
</Card>

Veo 3.1 is Google's advanced text-to-video model that transforms text prompts into high-quality cinematic videos. It supports resolutions up to 4K, durations of 4-8 seconds, and optional audio generation for complete multimedia output. Choose between **Standard** mode for maximum quality or **Fast** mode for quicker generation at lower cost.

### Key capabilities

* **Multi-resolution output**: Generate videos in 720p, 1080p, or 4K resolution
* **Audio generation**: Optional synchronized audio for complete multimedia content
* **Flexible durations**: 4, 6, or 8 second video outputs
* **Aspect ratio control**: 16:9 (landscape) or 9:16 (portrait) formats
* **Negative prompts**: Specify elements to avoid in generation
* **Two generation modes**: Standard (highest quality) and Fast (cost-efficient)
* **Long prompts**: Up to 20,000 characters for detailed descriptions
* **Reproducible results**: Seed parameter for consistent outputs

### Use cases

* **Marketing content**: Create promotional videos and product showcases from descriptions
* **Social media**: Generate engaging short-form content for TikTok, Reels, and Shorts
* **Storytelling**: Visualize narratives, concepts, and creative ideas
* **Advertising**: Produce video ads from text briefs
* **Education**: Create visual explanations and demonstrations
* **Prototyping**: Quickly visualize video concepts before production

### Generate with Veo 3.1 Standard

High-quality video generation with maximum fidelity and detail.

<div className="my-11">
  <Columns cols={2}>
    <Card title="POST /v1/ai/text-to-video/veo-3-1" icon="video" href="/api-reference/text-to-video/post-veo-3-1">
      Create a new text-to-video task
    </Card>

    <Card title="GET /v1/ai/text-to-video/veo-3-1" icon="list" href="/api-reference/text-to-video/get-veo-3-1">
      List all Veo 3.1 tasks
    </Card>

    <Card title="GET /v1/ai/text-to-video/veo-3-1/{task-id}" icon="magnifying-glass" href="/api-reference/text-to-video/get-veo-3-1-task">
      Get task status by ID
    </Card>
  </Columns>
</div>

### Generate with Veo 3.1 Fast

Faster generation at reduced cost, ideal for prototyping and high-volume workflows.

<div className="my-11">
  <Columns cols={2}>
    <Card title="POST /v1/ai/text-to-video/veo-3-1-fast" icon="bolt" href="/api-reference/text-to-video/post-veo-3-1-fast">
      Create a fast text-to-video task
    </Card>

    <Card title="GET /v1/ai/text-to-video/veo-3-1-fast" icon="list" href="/api-reference/text-to-video/get-veo-3-1-fast">
      List all Veo 3.1 Fast tasks
    </Card>

    <Card title="GET /v1/ai/text-to-video/veo-3-1-fast/{task-id}" icon="magnifying-glass" href="/api-reference/text-to-video/get-veo-3-1-fast-task">
      Get task status by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter         | Type      | Required | Description                                                           |
| ----------------- | --------- | -------- | --------------------------------------------------------------------- |
| `prompt`          | `string`  | Yes      | Text describing the video to generate (max 20,000 chars)              |
| `negative_prompt` | `string`  | No       | Text describing what to avoid in the video                            |
| `duration`        | `integer` | No       | Video duration: `4`, `6`, or `8` seconds (default: `8`)               |
| `resolution`      | `string`  | No       | Output resolution: `"720p"`, `"1080p"`, or `"4k"` (default: `"720p"`) |
| `aspect_ratio`    | `string`  | No       | Video format: `"16:9"` or `"9:16"` (default: `"16:9"`)                |
| `generate_audio`  | `boolean` | No       | Generate synchronized audio (default: `true`)                         |
| `seed`            | `integer` | No       | Random seed for reproducibility                                       |
| `webhook_url`     | `string`  | No       | URL for task completion notification                                  |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is the difference between Standard and Fast modes?">
    **Standard mode** produces the highest quality output with maximum detail and fidelity, ideal for final production content. **Fast mode** generates videos more quickly at a lower cost, making it perfect for prototyping, testing prompts, and high-volume workflows where speed matters more than maximum quality.
  </Accordion>

  <Accordion title="What resolutions are supported?">
    Veo 3.1 supports three resolution options: **720p** (HD), **1080p** (Full HD), and **4K** (Ultra HD). Higher resolutions provide more detail but may take longer to generate.
  </Accordion>

  <Accordion title="How does audio generation work?">
    When `generate_audio` is set to `true` (the default), Veo 3.1 synthesizes synchronized audio that matches the visual content. This includes ambient sounds, music, and effects appropriate to the scene described in your prompt.
  </Accordion>

  <Accordion title="How long does generation take?">
    Generation time varies based on resolution, duration, and server load. Fast mode typically completes in less time than Standard mode. Use webhooks for production workflows to avoid polling.
  </Accordion>

  <Accordion title="What makes a good prompt for Veo 3.1?">
    Effective prompts describe the scene, subjects, motion, camera movement, lighting, and atmosphere. Be specific about visual details. Example: *"A serene mountain landscape at sunset with clouds moving slowly across an orange sky, camera slowly panning right"*
  </Accordion>

  <Accordion title="Can I generate portrait videos for social media?">
    Yes, set `aspect_ratio` to `"9:16"` to generate vertical videos optimized for TikTok, Instagram Reels, and YouTube Shorts.
  </Accordion>
</AccordionGroup>

## Best practices

* **Prompt detail**: Provide specific descriptions of scenes, subjects, motion, and atmosphere for best results
* **Negative prompts**: Use `negative_prompt` to exclude unwanted elements like "blurry, low quality, distorted"
* **Resolution selection**: Choose 720p for fast iteration, 1080p for social media, 4K for high-end production
* **Audio control**: Disable `generate_audio` if you plan to add custom audio in post-production
* **Webhook integration**: Use webhooks instead of polling for scalable production applications
* **Seed for consistency**: Use the same seed with identical parameters to reproduce similar results

## Related APIs

* **[Veo 3.1 Image-to-Video](/api-reference/image-to-video/veo-3-1/overview)**: Generate videos from images with Veo 3.1
* **[Veo 3.1 Reference-to-Video](/api-reference/reference-to-video/veo-3-1/overview)**: Generate videos with consistent characters using reference images
* **[Kling 2.6 Pro](/api-reference/image-to-video/kling-v2-6-pro)**: Alternative image-to-video with motion control
* **[WAN 2.6](/api-reference/text-to-video/wan-v2-6-720p)**: Text-to-video at 720p and 1080p resolutions