AI Video Generate
AI Video Generate API
Overview
Asynchronous video generation flow:
- Create video job and get
job_id
- Wait about 45-60 seconds
- Check job status by
job_id
- When completed, read output URL in
result
Guide & Pricing
Authentication
Authorization: Bearer sk_live_your_key
Video Models
| Model |
Notes |
kling-2.5-turbo |
Fast Kling 2.5 |
kling-01-video |
Kling O1 video model |
kling-3.0 |
Kling 3.0 |
kling-2.6 |
Kling 2.6 |
veo-3.1 |
Veo 3.1 |
veo-3.1-fast |
Veo 3.1 fast |
veo-3.1-high |
Veo 3.1 high quality |
1) Create Video Job
- Method:
POST
- URL:
https://ai.revidapi.com/v1/video/generate
- Content-Type:
multipart/form-data
| Name |
Type |
Required |
Description |
prompt |
string |
Yes |
Video prompt |
model |
string |
Yes |
e.g. kling-2.6 |
mode |
string |
No |
e.g. t2v or i2v |
duration |
string |
No |
e.g. 5s, 10s |
aspect_ratio |
string |
No |
e.g. 16:9, 9:16 |
resolution |
string |
No |
e.g. 720p, 1080p |
speed |
string |
No |
e.g. fast |
audio |
boolean |
No |
Enable/disable audio |
input_image |
file |
No |
Input image for i2v |
img_url |
string |
No |
Image URL instead of input_image |
server_id |
string |
No |
Routing/server tier |
Curl example
curl -X POST https://ai.revidapi.com/v1/video/generate \
-H "Authorization: Bearer sk_live_your_key" \
-F "prompt=A cinematic shot..." \
-F "model=kling-2.6" \
-F "duration=5s" \
-F "aspect_ratio=16:9"
Create response example
{
"job_id": "job_123456789",
"status": "pending",
"cost": 10,
"balance_remaining": 1490
}
2) Check Job Status
- Method:
GET
- URL:
https://ai.revidapi.com/v1/jobs/{job_id}
Curl example
curl -X GET "https://ai.revidapi.com/v1/jobs/job_123456789" \
-H "Authorization: Bearer sk_live_your_key"
Processing response
{
"status": "processing",
"result": null
}
Completed response
{
"status": "completed",
"result": "https://storage.googleapis.com/.../video.mp4"
}
Error Codes
| Code |
Error |
Description |
| 400 |
Bad Request |
Missing params or invalid payload/file format. |
| 401 |
Unauthorized |
Missing or invalid API key. |
| 402 |
Insufficient Funds |
Not enough credits in your account. |
| 403 |
Forbidden |
API key has no permission for this resource. |
| 404 |
Not Found |
Requested job/resource does not exist. |
| 429 |
Too Many Requests |
Rate limit exceeded (1000 req/min). |
| 500 |
Internal Server Error |
Internal server error. |
| 503 |
Service Unavailable |
Model provider is overloaded or under maintenance. |