Google Veo3 1 Reference To Video

8 seconds, from 1152 credits
ae_veo3_1_reference_to_video

Create a video from a text prompt and reference images to help keep subjects visually consistent.

Video
8 seconds, from 1152 credits

Pricing

ConditionWithout audioWith audio
Three references, 8 seconds, 16:9, 720P / 1080P (standard parameters)1152 credits2304 credits
Other settings, 720P / 1080P1920 credits3840 credits
4K3840 credits5760 credits

Charges depend on the reference image setup, aspect ratio, resolution, audio, and applicable tier. Each result is settled once. Generation failures are free except when a content review has already incurred a charge.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.promptstringYesThe text prompt describing the video you want to generate—
request_body.auto_fixbooleanNoWhether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.false
request_body.durationstringNoThe duration of the generated video.8s
request_body.image_urlsarrayYesURLs of the reference images to use for consistent subject appearance—
request_body.resolutionenum (720p | 1080p | 4k)NoThe resolution of the generated video.720p
request_body.aspect_ratioenum (16:9 | 9:16)NoThe aspect ratio of the generated video.16:9
request_body.generate_audiobooleanNoWhether to generate audio for the video.true
request_body.safety_toleranceenum (1 | 2 | 3 | 4 | 5 | 6)NoThe safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.4

Invocation example

Parameter template

Generated from the parameter configuration. Replace the sample values before use.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_veo3_1_reference_to_video' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "prompt": "A chimpanzee wearing overalls frolics in the grassy field, gently playing with the butterflies. In the background, a circus tent and carousel beckon.",
      "image_urls": [
        "https://storage.googleapis.com/falserverless/example_inputs/veo31-r2v-input-1.png",
        "https://storage.googleapis.com/falserverless/example_inputs/veo31-r2v-input-2.png",
        "https://storage.googleapis.com/falserverless/example_inputs/veo31-r2v-input-3.png"
      ]
    }
  }
}'

No response example available yet.