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

# Create video with reference images - Veo 3.1

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

## Request

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

Generate a video with character or object consistency using reference images. Maintains visual identity across scenes for storytelling and multi-scene projects. Supports 720p, 1080p, and 4K resolutions with native audio generation including dialogue and sound effects. Fixed 8-second duration at 24 FPS.

## Request body

- Ref2vRequest
  - `webhook_url` string, uri: Webhook URL to notify when the task is completed
  - `image_urls` string[], required: Array of reference image URLs (1-3 images) for character or object consistency. Images must be publicly accessible HTTPS URLs.
  - `prompt` string, required: Text prompt describing the video to generate with the reference subjects
  - `negative_prompt` string: Text describing what to avoid in the generated video
  - `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 including dialogue and sound effects
  - `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)