Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt

Use this file to discover all available pages before exploring further.

APIYI provides two Veo 3.1 channels simultaneously. This page helps you pick by scenario: official quality + can accept async polling → Official (this series); cost-sensitive + need streaming sync or frame-to-video → Reverse (VEO 3.1). Both channels can be used in parallel under the same account without conflict.

​
Full Comparison Matrix

DimensionOfficial (this series)Reverse (existing VEO 3.1)
Channel typeTransparent passthrough to Google AI StudioReverse-engineered access to Google Flow
Model IDsveo-3.1-generate-preview / veo-3.1-fast-generate-previewveo-3.1 / veo-3.1-fast / -landscape / -fl series (8 variants)
Billing modePay-per-request (independent of duration / resolution)Pay-per-request (independent of duration / resolution)
Price$0.3 (fast) / $1.2 (standard)$0.15 (fast) / $0.25 (standard) — 50–75% cheaper
Endpoint pathsPOST /v1/videos only (async)POST /v1/chat/completions (streaming sync) + POST /v1/videos (async)
Streaming sync❌ Async polling only✅ Supports stream: true for live progress
Duration4 / 6 / 8 seconds (string)Fixed 8 seconds
Resolution720p / 1080p / 4k (three tiers)HD landscape (1280×720) / portrait (720×1280)
Reference image1 image via input_reference (multipart)1–2 images (supports frame-to-video with -fl series)
Landscape / portraitVia aspectRatio parameterVia model ID (-landscape series)
GroupDefaultDefault
Billing modelPay-per-request ✅ / Pay-as-you-go Priority ✅ (pure Pay-as-you-go ❌)Pay-per-request ✅ / Pay-as-you-go Priority ✅
Response fieldsid / task_id / status / progress (coarse 0/50/100)Sync: full chat completion; async: task_id / status
Failed billing❌ Not billed❌ Not billed
AudioNative synchronized audioNative synchronized audio
When to useProduction needing official quality + can accept async pollingCost-sensitive, needs sync UI progress, needs frame-to-video

​
Three-Step Decision Tree

1

Q1: Do you need frame-to-video capability?

  • Yes → Use VEO 3.1 (Reverse) -fl series (e.g., veo-3.1-landscape-fast-fl); Official does not yet expose frame-to-video
  • No → Go to Q2
2

Q2: Does your frontend need a streaming sync progress bar?

  • Yes (user-facing UI can’t go blank) → Use VEO 3.1 (Reverse) /v1/chat/completions streaming endpoint
  • Backend tasked (queue consumer, batch production) → Go to Q3
3

Q3: Budget vs quality priority?

  • Budget first ($0.15 vs $0.3 difference matters) → Use VEO 3.1 (Reverse), 50% lower price
  • Quality / stability first (final delivery, 4K, strong instruction following) → Use Official (this series) with veo-3.1-generate-preview
  • Iteration / preview → Use Official veo-3.1-fast-generate-preview ($0.3) or Reverse -fast ($0.15)

​
Scenario-by-Scenario Recommendations

Business scenarioRecommended channelRecommended modelWhy
Short-video matrix batch production (100+/day)Reverseveo-3.1-landscape-fast$0.15 unit price, controllable batch cost
Final client ad deliveryOfficialveo-3.1-generate-previewStable official quality + 4K optional
Frontend live display (needs loading animation)Reverseveo-3.1-landscape-fast + streaming syncVisible progress, avoids blank-wait anxiety
Static poster + frame-to-video → motion clipReverseveo-3.1-landscape-fast-flFrame-to-video capability
4K cinematic clips (hero asset)Officialveo-3.1-generate-preview + resolution=4kOnly Official supports 4K
Overseas team onboarding (existing Key unchanged)Officialveo-3.1-fast-generate-previewDefault group + pay-per-request, zero friction
Same-prompt multi-seed style explorationOfficialveo-3.1-fast-generate-preview4–6 sec optional, low iteration cost
Iteration + final delivery workflowMixedReverse fast iterate → Official standard finalCheap iteration, stable delivery

​
Can I use both channels together?

Absolutely. The two channels are independently routed:
  • Under the same account, a single Token (on the Default group) can call both channels simultaneously; billing is tracked per-call
  • Switch the model field as needed in your business code:
    • To use Official → veo-3.1-fast-generate-preview / veo-3.1-generate-preview
    • To use Reverse → veo-3.1-fast / veo-3.1-landscape / veo-3.1-fl etc.
Recommended setup: Route “business-critical delivery” to Official, route “iteration / batch previews / sync UI” to Reverse. Unified account, clean billing, complementary capabilities.