Overview

Use Veo 3 to render premium marketing footage with granular control over lighting, lensing, soundtrack, and pacing. The model excels at tabletop products, lifestyle sequences, and narrative ad spots.

Request Structure

curl -X POST "https://api.transendai.net/v1/videos/veo3/generation" \
  -H "Authorization: Bearer $TRANSEND_API_KEY" \
  -H "Content-Type": "application/json" \
  -d '{
    "script": [
      { "shot": "hero", "prompt": "Product rotating on reflective surface", "duration": 10, "lighting": "softbox", "fov": 35 },
      { "shot": "macro", "prompt": "Macro detail with water droplets", "duration": 8, "lighting": "rim-light", "fov": 85 }
    ],
    "soundtrack": "uplifted-synthwave",
    "color_grade": "brand-teal",
    "callback_url": "https://studio.example.com/hooks/veo"
  }'

Parameters

Field	Type	Notes
`script`	array	Ordered shots with individual prompts, durations (seconds), and optional lens settings.
`lighting`	string	Choose from `softbox`, `three-point`, `sunrise`, `noir`, `custom`.
`fov`	number	Field of view in millimetres (24–120).
`soundtrack`	string	Optional licensed audio from the Transend catalog.
`color_grade`	string	Brand LUT preset or custom ID.
`callback_url`	string	Receives task updates (signed HMAC payload).

Output Payload

{
  "task_id": "task_veo_947a",
  "status": "succeeded",
  "result": {
    "video_url": "https://edge.transendai.net/video/task_veo_947a.mov?signature=...",
    "audio_track": "https://edge.transendai.net/audio/task_veo_947a.mp3",
    "shots": [
      { "shot": "hero", "start": 0, "end": 10 },
      { "shot": "macro", "start": 10, "end": 18 }
    ]
  }
}

Results include timecoded shot metadata so editors can jump directly to each segment.

Lighting Presets

Preset	Description
`softbox`	Even key lighting for smooth falloff and product clarity.
`rim-light`	Adds backlight accents around reflective surfaces.
`moody-lowkey`	Dramatic contrast for luxury campaigns.
`sunrise`	Warm directional lighting with slow intensity ramp.

You can override presets by specifying a lighting object with RGB temperatures, intensity, and direction vectors.

Soundtrack Controls

Supply either an ID from the built-in catalog or upload stems using the asset management API. When providing multiple stems, Veo will auto-mix them according to the timeline structure.

Error Handling

Code	Cause	Suggested fix
`400`	Conflicting durations or unsupported FOV.	Ensure total shot duration ≤ 45 seconds and FOV is between 24–120.
`415`	Unsupported soundtrack format.	Upload MP3/WAV at 44.1kHz or use catalog IDs.
`502`	Downstream rendering issue.	Retry with the same `task_id`; the system resumes from checkpoints.

Tips

Keep copy variations in shot metadata; the JSON response helps editors align overlays later.
Pair with the pricing dashboard to track spend by campaign and brand.
Use signed callback_url tokens to prevent third-party spoofing.

Veo 3 API