VeoForge Engine API Reference

Programmatic wholesale access to Google Flow Ultra Veo 3.1 video generation, Nano Banana Pro 8K packaging, and autonomous fleet queue telemetry.

Open Web Studio Admin Telemetry

POST/api/generate/video

Submit Video Generation Job

Auth: Required (Bearer)0 Credits (Unlimited Lite Tier) or 25 Units ($0.025) on Fast Tier

Dispatches an asynchronous rendering job to the Google Flow Ultra workhorse pool running Veo 3.1 Lite. Returns an immediate job identifier for polling.

Code Implementation Examples

Terminal cURL

curl -X POST https://veoforge.dev/api/generate/video \
  -H "Authorization: Bearer vf_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Cinematic 35mm film still of a vintage watchmaker assembling gears, golden hour light --ar 16:9",
    "model": "veo-3.1-lite-lower-priority",
    "aspectRatio": "16:9"
  }'

Request JSON Body

{
  "prompt": "Cinematic wide-angle drone shot skimming over dense mist-shrouded pine trees, early morning golden light piercing through fog, photorealistic 8k texture, organic camera drift --ar 16:9",
  "model": "veo-3.1-lite-lower-priority",
  "aspectRatio": "16:9",
  "asyncMode": true
}

HTTP 200 Response Payload

{
  "success": true,
  "jobId": "vf_job_8f29c1b7a4e0",
  "status": "queued",
  "estimatedDurationSeconds": 35,
  "model": "veo-3.1-lite-lower-priority",
  "queuePosition": 1
}

Gateway Error Codes & Failover Protocols

VeoForge incorporates hardware circuit breakers that automatically recover from rate limits, cooldowns, and upstream UI shifts without client-side intervention.

HTTP STATUS	TRIGGER CONDITION	AUTOMATED ENGINE RESOLUTION
401 Unauthorized	Missing or invalid Bearer token	Verify your token starts with vf_live_...
429 Rate Limited	Tenant concurrency limit reached	Engine queues request or dispatches to warm standby pool
503 Degraded	Upstream Google Flow cooldown / maintenance	Salad GPU fallback circuit activates automatically