Veo 3.1 (Reference to Video) · Image to video

← Veo Model name: veo3.1/reference-to-video
Generation type: image_to_video
Endpoint: POST /api/asset_generator/

Pricing

32.0 credits per output. Prices are per output. When a request asks for several outputs, the charge is this price times the number of outputs.

Quick start

The example uses sample media from our CDN. Swap in publicly accessible URLs for your own files.

curl --request POST \
  --url https://api.creatify.ai/api/asset_generator/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: your-api-id' \
  --header 'X-API-KEY: your-api-key' \
  --data '{
    "model_name": "veo3.1/reference-to-video",
    "input_params": {
      "prompt": "She looks up from her laptop and smiles at the camera.",
      "image_urls": [
        "https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
      ]
    }
  }'

import requests

response = requests.post(
    "https://api.creatify.ai/api/asset_generator/",
    headers={"X-API-ID": "your-api-id", "X-API-KEY": "your-api-key"},
    json={
        "model_name": "veo3.1/reference-to-video",
        "input_params": {
            "prompt": "She looks up from her laptop and smiles at the camera.",
            "image_urls": [
                "https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
            ]
        },
    },
)
print(response.json()["id"])

Input parameters

Send these fields in input_params.

string

required

The text prompt describing the video you want to generateMinimum characters: 1. Maximum characters: 2000.

string[]

required

URLs of the reference images to use for consistent subject appearanceMinimum items: 1. Maximum items: 3.

string

default:"8s"

The duration of the generated video in seconds (reference-to-video only supports 8s)Allowed values: "8s".

string

default:"720p"

The resolution of the generated videoAllowed values: "720p", "1080p".

string

default:"16:9"

The aspect ratio of the generated video.Allowed values: "16:9", "9:16".

boolean

default:true

Whether to generate audio for the video.

string

A negative prompt to guide the video generation

Complete JSON schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "prompt",
    "image_urls"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "title": "Prompt",
      "maxLength": 2000,
      "minLength": 1,
      "description": "The text prompt describing the video you want to generate"
    },
    "duration": {
      "enum": [
        "8s"
      ],
      "type": "string",
      "title": "Duration",
      "default": "8s",
      "description": "The duration of the generated video in seconds (reference-to-video only supports 8s)"
    },
    "image_urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "title": "Image URLs",
      "maxItems": 3,
      "minItems": 1,
      "description": "URLs of the reference images to use for consistent subject appearance"
    },
    "resolution": {
      "enum": [
        "720p",
        "1080p"
      ],
      "type": "string",
      "title": "Resolution",
      "default": "720p",
      "description": "The resolution of the generated video",
      "x-advance-settings": true
    },
    "aspect_ratio": {
      "enum": [
        "16:9",
        "9:16"
      ],
      "type": "string",
      "title": "Aspect Ratio",
      "default": "16:9",
      "description": "The aspect ratio of the generated video."
    },
    "generate_audio": {
      "type": "boolean",
      "title": "Generate Audio",
      "default": true,
      "description": "Whether to generate audio for the video.",
      "x-advance-settings": true
    },
    "negative_prompt": {
      "type": "string",
      "title": "Negative Prompt",
      "description": "A negative prompt to guide the video generation",
      "x-advance-settings": true
    }
  }
}

Response

The request returns the task with status: "initializing". Poll GET /api/asset_generator/{id}/ until status is done or failed, or pass a webhook_url to be notified. A finished task lists its files in assets and the credits it charged in credits_used.

Get Started

URL to Video

Aurora

Boreal

Stock AI Avatar

Custom Avatar

Custom Template

Asset Generator

Ad Clone

Text to Speech

IAB Images

HTML Interactive Ad

Link Parser

AI Ad Script

Stock AI Voice

Stock AI Music

Workspace

AI Shorts (Deprecated)

AI Editing (Deprecated)

Product Video (Deprecated)

Veo 3.1 (Reference to Video) · Image to video

Pricing

Quick start

Input parameters

Response

​Pricing

​Quick start

​Input parameters

​Response

Pricing

Quick start

Input parameters

Response