Video

Veo 3.1 (Reference)

Credit-based pricing. Supports reference images, audio generation.

Try Veo 3.1 (Reference) →Compare models

Output

video

Aspect ratio

16:9

Resolution

720p, 1080p, 4k

Duration

Inputs

Reference image (required)

Generates audio

Example prompt

Provide a reference portrait and a scene description — Veo 3.1 places your character into any cinematic world

Try this prompt →

LLM-ready

API & LLM schema

Exact request contract for this model. Agents can fetch it from /api/v1/models?id=fal-ai/veo3.1/reference-to-video.

POST/api/v1/generate15 fields · 3 required

Field	Type	Requirement	Contract
`model_id`	constant	Required	ArtEmotion model identifier.
`extra`	object	Optional	Model-specific settings may also be nested here.
`max_credits`	number	Optional	Reject before submission if the estimated list price exceeds this cap. · Range: 1–…
`webhook_url`	string	Optional	Format: uri
`webhook_secret`	string	Optional	Optional model input.
`folder_id`	string	Optional	Optional model input.
`prompt`	string	Required	Optional model input.
`auto_fix`	boolean	Optional	Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them. · Default: false
`safety_tolerance`	number	Optional	The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict. · Allowed: 1, 2, 3, 4, 5, 6 · Default: 4
`seed`	integer	Optional	The seed for the random number generator.
`negative_prompt`	string	Optional	A negative prompt to guide the video generation.
`aspect_ratio`	string	Optional	Allowed: 16:9
`resolution`	string	Optional	Allowed: 720p, 1080p, 4k
`duration`	number	Optional	Allowed: 8
`reference_image_urls`	array<string>	Required	Items: 0–3

Minimal request example

{
  "model_id": "fal-ai/veo3.1/reference-to-video",
  "prompt": "Provide a reference portrait and a scene description — Veo 3.1 places your character into any cinematic world",
  "reference_image_urls": []
}

Raw JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fveo3.1%2Freference-to-video",
  "title": "Veo 3.1 (Reference) generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/veo3.1/reference-to-video.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/veo3.1/reference-to-video",
      "description": "ArtEmotion model identifier."
    },
    "extra": {
      "type": "object",
      "additionalProperties": true,
      "description": "Model-specific settings may also be nested here."
    },
    "max_credits": {
      "type": "number",
      "minimum": 1,
      "description": "Reject before submission if the estimated list price exceeds this cap."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048
    },
    "webhook_secret": {
      "type": "string",
      "maxLength": 512
    },
    "folder_id": {
      "type": "string"
    },
    "prompt": {
      "type": "string"
    },
    "auto_fix": {
      "title": "Auto Fix",
      "description": "Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.",
      "default": false,
      "type": "boolean"
    },
    "safety_tolerance": {
      "title": "Safety Tolerance",
      "description": "The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.",
      "default": "4",
      "type": "number",
      "enum": [
        1,
        2,
        3,
        4,
        5,
        6
      ]
    },
    "seed": {
      "title": "Seed",
      "description": "The seed for the random number generator.",
      "type": "integer"
    },
    "negative_prompt": {
      "title": "Negative Prompt",
      "description": "A negative prompt to guide the video generation.",
      "type": "string"
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "16:9"
      ]
    },
    "resolution": {
      "type": "string",
      "enum": [
        "720p",
        "1080p",
        "4k"
      ]
    },
    "duration": {
      "type": "number",
      "enum": [
        8
      ]
    },
    "reference_image_urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "maxItems": 3
    }
  },
  "required": [
    "model_id",
    "prompt",
    "reference_image_urls"
  ],
  "additionalProperties": false
}

Browse schemas for every ArtEmotion model →

FAQ

How much does Veo 3.1 (Reference) cost on ArtEmotion?

Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.

Do I get my credits back if Veo 3.1 (Reference) fails?

Yes — failed generations are never charged. The credits are released back to your balance automatically.

Can I call Veo 3.1 (Reference) from the API?

Yes. Use POST /api/v1/generate with model_id: "fal-ai/veo3.1/reference-to-video". See the API reference for the full schema.

Where are my generations stored?

Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.

Ready to generate with Veo 3.1 (Reference)?

Start now →

No commitment. New accounts get 50 free credits on signup. See pricing.