AI Video Generate

API AI Video Generate¶

Tổng quan¶

Endpoint tạo video theo cơ chế bất đồng bộ:

Gọi API tạo video để lấy job_id
Chờ xử lý (thường khoảng 45 giây - 1 phút)
Gọi API kiểm tra trạng thái theo job_id
Khi status = completed, lấy link video từ result

Hướng dẫn & bảng giá¶

Xem dashboard, hướng dẫn sử dụng và bảng giá mới nhất tại: app.revidapi.com

Xác thực¶

Authorization: Bearer sk_live_your_key

Bảng model AI Video¶

Model	Mô tả ngắn
`kling-2.5-turbo`	Bản nhanh của Kling 2.5
`kling-01-video`	Kling 01 Video
`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 bản nhanh
`veo-3.1-high`	Veo 3.1 bản chất lượng cao

1) Tạo Job Video¶

Method: POST
URL: https://ai.revidapi.com/v1/video/generate
Content-Type: multipart/form-data

Tham số form-data¶

Tên	Kiểu	Bắt buộc	Mô tả
`prompt`	string	Có	Mô tả video cần tạo
`model`	string	Có	Ví dụ: `kling-2.6`
`mode`	string	Không	Ví dụ: `t2v` hoặc `i2v`
`duration`	string	Không	Ví dụ: `5s`, `10s`
`aspect_ratio`	string	Không	Ví dụ: `16:9`, `9:16`
`resolution`	string	Không	Ví dụ: `720p`, `1080p`
`speed`	string	Không	Ví dụ: `fast`
`audio`	boolean	Không	Bật/tắt audio
`input_image`	file	Không	Ảnh đầu vào cho i2v
`img_url`	string	Không	URL ảnh thay cho `input_image`
`server_id`	string	Không	Server tier

Curl mẫu¶

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"

Kết quả trả về¶

{
  "job_id": "job_123456789",
  "status": "pending",
  "cost": 10,
  "balance_remaining": 1490
}

2) Kiểm tra trạng thái Job¶

Method: GET
URL: https://ai.revidapi.com/v1/jobs/{job_id}

Curl mẫu¶

curl -X GET "https://ai.revidapi.com/v1/jobs/job_123456789" \
  -H "Authorization: Bearer sk_live_your_key"

Đang xử lý¶

{
  "status": "processing",
  "result": null
}

Hoàn thành¶

{
  "status": "completed",
  "result": "https://storage.googleapis.com/.../video.mp4"
}

Mã lỗi¶

Code	Lỗi	Mô tả
400	Bad Request	Thiếu tham số hoặc payload/file không hợp lệ.
401	Unauthorized	Thiếu hoặc sai API key.
402	Insufficient Funds	Không đủ credits trong tài khoản.
403	Forbidden	API key không có quyền truy cập tài nguyên này.
404	Not Found	Job/tài nguyên không tồn tại.
429	Too Many Requests	Vượt giới hạn tốc độ (1000 req/phút).
500	Internal Server Error	Lỗi server nội bộ.
503	Service Unavailable	Nhà cung cấp model đang quá tải hoặc bảo trì.