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

# Veo 3.1 Fast Reference

> Generate an 8-second 1080p video from one to three required references.

`veo3-1-fast-ref` is the dedicated reference-guided Veo route. Unlike the other Veo models, it requires one to three public images.

| Property   | Value                           |
| ---------- | ------------------------------- |
| Model ID   | `veo3-1-fast-ref`               |
| Duration   | Fixed 8 seconds                 |
| Resolution | 1920x1080 or 1080x1920          |
| References | Required, 1-3 public images     |
| Price      | \$0.25 per request (25 credits) |

<ParamField body="model" type="string" required>Set to `veo3-1-fast-ref`.</ParamField>
<ParamField body="prompt" type="string" required>Describe how the references should guide the result.</ParamField>
<ParamField body="seconds" type="string" required>Set to `"8"`.</ParamField>
<ParamField body="aspect_ratio" type="string" default="16:9">Use `16:9` or `9:16`.</ParamField>
<ParamField body="image_urls" type="string[]" required>Send one to three public reference-image URLs.</ParamField>

## Request

```bash theme={null}
curl https://api.snapgen.org/v1/videos \
  -H "Authorization: Bearer $SNAPGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo3-1-fast-ref",
    "prompt": "Keep the supplied character and product consistent in a slow studio orbit",
    "seconds": "8",
    "aspect_ratio": "16:9",
    "image_urls": [
      "https://example.com/character.jpg",
      "https://example.com/product.jpg",
      "https://example.com/style.jpg"
    ]
  }'
```

Follow the [Video API workflow](/api-reference/video-generation) and include `model=veo3-1-fast-ref` when polling and downloading.

<Warning>
  A text-only request is invalid for this model. Supply at least one public
  `image_urls` entry and no more than three.
</Warning>
