Veo 3.1 Video Generation

# Step 1: Submit task
curl -X POST https://easyrouter.io/v1/video/generations \
  -H "Authorization: Bearer sk-YourApiKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-generate-001",
    "prompt": "A golden retriever playing fetch on a sunny beach, cinematic wide shot, slow motion",
    "size": "1080p",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

# Step 2: Poll (recommended interval: 10~15 seconds)
curl https://easyrouter.io/v1/video/generations/task_DduhCcHShyasO6lCV7o5SK9JQEYUnO1j \
  -H "Authorization: Bearer sk-YourApiKey"

# Step 3: When data.status == "succeeded", download from data.url
curl -o output.mp4 "https://easyrouter.io/v1/videos/task_DduhCcHShyasO6lCV7o5SK9JQEYUnO1j/content"

# Enable generate_audio: true for synchronized speech, sound effects, and ambient sound
curl -X POST https://easyrouter.io/v1/video/generations \
  -H "Authorization: Bearer sk-YourApiKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-generate-001",
    "prompt": "A jazz musician performing on a rainy street at night, neon lights reflecting on wet pavement",
    "size": "1080p",
    "duration": 8,
    "generate_audio": true
  }'

# Pass a reference image via images
# The model generates motion starting from this image
curl -X POST https://easyrouter.io/v1/video/generations \
  -H "Authorization: Bearer sk-YourApiKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-generate-001",
    "prompt": "The cat slowly opens its eyes and stretches, sunlight streaming through the window",
    "images": ["https://example.com/cat.jpg"],
    "size": "1080p",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

# 9:16 portrait i2v + synchronized audio — common e-commerce short-form video case
curl -X POST https://easyrouter.io/v1/video/generations \
  -H "Authorization: Bearer sk-YourApiKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-fast-generate-001",
    "prompt": "Reference image constraint: use images[0] as the exact first frame. Preserve subject, color, logo and composition. Animate natural product motion only.",
    "images": ["https://your-bucket.example.com/product.png"],
    "size": "1080p",
    "duration": 6,
    "aspect_ratio": "9:16",
    "generate_audio": true
  }'

# Veo 3.1 only: pass first + last frame, the model interpolates the transition
curl -X POST https://easyrouter.io/v1/video/generations \
  -H "Authorization: Bearer sk-YourApiKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-generate-001",
    "prompt": "Smooth cinematic transition between a serene garden and a bustling city.",
    "image": "https://example.com/start.jpg",
    "last_frame_image": "https://example.com/end.jpg",
    "size": "1080p",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

# referenceImages: use multiple reference images to keep subject/scene consistent
# (mutually exclusive with image / last_frame_image)
curl -X POST https://easyrouter.io/v1/video/generations \
  -H "Authorization: Bearer sk-YourApiKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-generate-001",
    "prompt": "The same character walks through a futuristic neon-lit city at night, cinematic.",
    "reference_images": [
      "https://example.com/character-front.png",
      "https://example.com/character-side.png",
      "https://example.com/scene-style.png"
    ],
    "size": "1080p",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'