POST
/
api
/
v1
/
veo
/
generate
Generate Veo3 Video
curl --request POST \
  --url https://api.kie.ai/api/v1/veo/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A dog playing in a park",
  "imageUrls": [
    "http://example.com/image1.jpg"
  ],
  "model": "veo3",
  "watermark": "MyBrand",
  "callBackUrl": "http://your-callback-url.com/complete",
  "aspectRatio": "16:9",
  "seeds": 12345,
  "enableFallback": false
}'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "veo_task_abcdef123456"
  }
}
Create a new video generation task using the Veo3 API.
Our Veo 3 Generation API is more than a direct wrapper around Google’s baseline. It layers extensive optimisation and reliability tooling on top of the official models, giving you greater flexibility and markedly higher success rates — all at less than 20 % of the official Google pricing (see kie.ai/billing for full details).
CapabilityDetails
Models• Veo 3 Quality — flagship model, highest fidelity
• Veo 3 Fast — cost‑efficient variant (~20 % of Quality pricing) that still delivers strong visual results
Tasks• Text → Video
• Image → Video (single reference frame)
Aspect RatiosNative 16 : 9. We transparently re‑frame to 9 : 16 via a proprietary post‑process, so vertical output is available without extra work on your side.
LanguagesGoogle’s native support is English‑only; our multilingual prompt pre‑processing extends reliable generation to most major languages.
Audio TrackAll videos ship with background audio by default. In < 5 % of cases Google suppresses audio when the scene is deemed sensitive (e.g. minors).
Content GovernanceGoogle enforces strict safety filters that often block celebrity or even ordinary‑person photos. We mitigate the majority of these false positives through an optional Intelligent Fallback (see below).

​
Why our Veo 3 API is different

  1. True vertical video – Native Veo 3 ignores 9 : 16; we deliver it via automatic re‑framing, saving you a manual editing pass.
  2. Global language reach – Prompt sanitisation, token‑weight rebalancing and fallback detection jointly lift non‑English success rates far above stock Veo 3 behaviour.
  3. False‑positive rescue – Optional fallback to an alternate Veo 3 backend recovers jobs blocked by over‑zealous moderation (at a higher credit cost).
  4. Significant cost savings – Our rates are under 20 % of Google’s direct API pricing.

​
Intelligent Fallback (enableFallback)

We’ve added a fallback mechanism to the Veo 3 API. If Google’s strict content filters wrongly flag a normal prompt or image—triggering errors like “public error minor upload,” “content policy violations,” or “public error prominent people upload”—you can now reroute the request through an alternative, more lenient Veo 3 channel.
The fallback uses the same Veo 3 model, with audio and the same quality; only the path changes, greatly reducing false positives and boosting success rates.
PropertyTypeDefault
enableFallbackbooleanfalse
Setting enableFallback: true instructs the platform to reroute eligible failures to the secondary Veo 3 backend, raising completion rates for edge cases.

​
Trigger conditions

Fallback runs only when the primary request fails with:
  • public_error_minor_upload
  • Content‑policy violation
  • public_error_prominent_people_upload
All other errors return immediately; successful primary runs never invoke fallback.

​
Limitations

  • 16 : 9 only – non‑conforming inputs are auto‑cropped before retry.
  • Resolution – fallback-generated videos are created in 1080p resolution by default but cannot be accessed via the Get 1080P Video endpoint.
  • Billing – a successful fallback consumes a separate (higher‑priced) credit tier. See kie.ai/billing for the exact table.

​
Behaviour when disabled

With enableFallback left at false (default), the errors above surface as HTTP 422 responses and no additional credits are consumed.

​
Fallback Functionality

By setting the enableFallback parameter, you can enable intelligent fallback functionality. When the primary model encounters specific errors, the system will automatically switch to a backup model to continue generation, improving task success rates.
Fallback Features:
  • Enabling Conditions: Set enableFallback: true, aspect ratio 16:9, and encounter specific errors
  • Applicable Errors: public error minor upload, content policy violations, public error prominent people upload
  • Image Requirements: Must be 16:9 ratio, otherwise automatic cropping will occur
  • Credit Calculation: Successful fallback has different credit consumption, please see https://kie.ai/billing for billing details
Important Notes
  • Fallback functionality only takes effect in specific error scenarios
  • When fallback is not enabled, encountering fallback-eligible errors will return a 422 status code
  • Fallback-generated videos are created in 1080p resolution by default but cannot be accessed via the Get 1080P Video endpoint

Authorizations

​
Authorization
string
header
required

All APIs require authentication via Bearer Token.

Get API Key:

  1. Visit API Key Management Page to get your API Key

Usage: Add to request header: Authorization: Bearer YOUR_API_KEY

Body

application/json

Response

200
application/json

Request successful

The response is of type object.