{"uid":"cap_p9BTKO7QuNHoPMxTT8F8W","slug":"video-withzero-xyz-google-veo-3-1-text-to-video-generation-maximum-4d2c4483","name":"Google Veo 3.1 Text-to-Video Generation (Maximum Fidelity)","description":"Generate a video from a text prompt with Google Veo 3.1 — maximum visual fidelity up to 4K with native audio. Returns a job id; poll the status route for the finished video URL.","url":"https://video.withzero.xyz/api/v1/videos/veo-3.1","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","example":{"prompt":"A slow aerial shot over a foggy pine forest at dawn","duration":8},"required":["prompt","duration","resolution","audio"],"properties":{"seed":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"description":"Seed for repeatable generation (best effort)."},"audio":{"type":"boolean","default":true,"description":"Generate a synchronized audio track."},"prompt":{"type":"string","maxLength":4000,"minLength":1,"description":"Text description of the video to generate."},"duration":{"anyOf":[{"type":"number","const":4},{"type":"number","const":6},{"type":"number","const":8}],"default":8,"description":"Clip length in seconds. One of: 4, 6, 8."},"resolution":{"enum":["720p","1080p","4K"],"type":"string","default":"1080p","description":"Output resolution. One of: 720p, 1080p, 4K."},"aspect_ratio":{"enum":["16:9","9:16"],"type":"string","description":"Aspect ratio of the output. One of: 16:9, 9:16."}},"additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["job_id","status","model","price_usdc","poll_path"],"properties":{"model":{"type":"string","description":"The model generating the video."},"job_id":{"type":"string","description":"Job id for the generation. Poll the status route with this id."},"status":{"type":"string","const":"pending","description":"The job has been accepted and is generating."},"poll_path":{"type":"string","description":"Path of the free status route to poll for the finished video."},"price_usdc":{"type":"string","description":"The amount charged for this generation, in USDC."}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.8","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.8/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.8","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.8","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_78R0TwNlT07-KwnzKdTgl","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.8","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"video.veo-3.1:1"}],"brandName":"video.withzero.xyz","brandSlug":"video-withzero-xyz-mpp","brandBaseUrl":"https://video.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Generates a high-fidelity video with native audio from a text prompt using Google Veo 3.1, supporting up to 4K resolution and 8-second clips, returning a job ID for async polling.","exampleAgentPrompt":"Use Google Veo 3.1 to generate an 8-second 4K video in 16:9 format with audio of a lone surfer riding a massive ocean wave at golden hour, crashing foam in slow motion.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a job_id, status ('pending'), the model name ('veo-3.1'), the price charged in USDC, and a poll_path URL to check for the finished video once rendering is complete.","failureModes":["Invalid or empty prompt returns 400 validation error","Unsupported duration value (not 4, 6, or 8) returns schema validation error","Unsupported resolution value returns enum validation error","Job creation fails due to upstream Google Veo API outage — may return 502 or 503","Polling the job ID may return 'failed' status if content policy is violated or generation errors out","Timeout or long queue times at 4K resolution may result in extended pending state"],"whenToPreferThis":"Choose this endpoint when maximum visual fidelity is the priority — specifically when 4K resolution or the highest-quality Google Veo 3.1 output is required. Prefer the Fast variant if speed matters more than quality, or Kling/Sora endpoints for different motion aesthetics. Best for cinematic, professional, or high-production-value video generation tasks.","instructions":"# Async — submit returns a job, not the finished video.\n\n## Workflow\n- Poll result: GET /api/v1/jobs/{job_id} (free) → `status`: in_progress | completed | failed.\n- Use the `job_id` (or `poll_path`) from this response; poll until status leaves in_progress, then read `url` on completed or `error` on failed.\n\n## Contract\n- Charged once on submit (see `price_usdc`); polling the job is free. Re-POSTing this route re-charges — to retry a slow job, keep polling, don't resubmit.","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-07-29T00:21:29.772Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:34:15.631Z","isFirstParty":true}