reference-to-video

Create video with reference images - Veo 3.1

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.

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

Request body

webhook_urlstring uri

Webhook URL to notify when the task is completed

image_urlsstring[] required

Array of reference image URLs (1-3 images) for character or object consistency. Images must be publicly accessible HTTPS URLs.

promptstring required

Text prompt describing the video to generate with the reference subjects

negative_promptstring

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_audioboolean

Whether to generate audio for the video including dialogue and sound effects

seedinteger

Random seed for reproducibility

Example request

{
  "image_urls": [
    "https://example.com/character1.jpg",
    "https://example.com/character2.jpg"
  ],
  "prompt": "The character walks through a futuristic city at night",
  "negative_prompt": "blurry, low quality, distorted"
}

Response

OK - The task exists and the status is returned

Example response

{
  "data": {
    "generated": [
      "https://openapi-generator.tech",
      "https://openapi-generator.tech"
    ],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.