Veo Video Generation

Submit video generation tasks. Supports veo3.1-fast, veo3.1-quality, and veo3.1-lite models, with text-to-video and image-to-video support. Tasks immediately return a task ID and generate asynchronously in the background.

• Base URL: https://apione.org
• Endpoint: POST /v1/videos/generations
• Authentication: Authorization: Bearer sk-xxxxxxxxxxxx
• Result Query: GET /v1/api/result?id={task_id} (see Async Result Query)

Video generation is always asynchronous. task_id is returned immediately. Video links are valid for 24 hours — save them promptly.

Submission Response (all models)

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Model Comparison

veo3.1-fast

Fast video generation, supports text-to-video and image-to-video, fixed 8-second duration.

curl --request POST \
  --url https://apione.org/v1/videos/generations \
  --header 'Authorization: Bearer sk-xxxxxxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1-fast",
    "prompt": "Dolphins leaping in the azure ocean",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

Parameters: prompt, duration (fixed 8), aspect_ratio (16:9/9:16), image_urls (up to 3), generation_type (frame/reference), resolution (720p/1080p/4k), enable_gif, official_fallback

image_urls modes:

• 2 images + generation_type: frame → keyframe video (first & last frame)
• 3 images + generation_type: reference → reference image video

veo3.1-quality

High-quality video generation for final delivery. Does not support generation_type: reference.

curl --request POST \
  --url https://apione.org/v1/videos/generations \
  --header 'Authorization: Bearer sk-xxxxxxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1-quality",
    "prompt": "A majestic eagle soaring over snow-capped mountains at dawn",
    "duration": 8,
    "aspect_ratio": "16:9",
    "resolution": "1080p"
  }'

veo3.1-lite

Lightweight model for low-cost bulk generation. Text-to-video only — image_urls and generation_type are not supported.

curl --request POST \
  --url https://apione.org/v1/videos/generations \
  --header 'Authorization: Bearer sk-xxxxxxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1-lite",
    "prompt": "A red panda playing in autumn leaves",
    "duration": 8,
    "aspect_ratio": "9:16",
    "resolution": "720p"
  }'