KOL AI Generate

API KOL AI Generate¶

Tổng quan¶

Tạo video avatar KOL từ ảnh + audio đã upload.

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

1) Tạo Job KOL AI¶

Method: POST
URL: https://ai.revidapi.com/v1/kol-ai/generate
Content-Type: application/json

Tham số request¶

Tên	Kiểu	Bắt buộc	Mô tả
`audio_id`	string	Có	ID audio đã upload
`audio_url`	string	Có	URL file audio
`image_url`	string	Có	URL ảnh nhân vật
`prompt`	string	Không	Prompt bổ sung
`quality`	string	Không	`1080p` (mặc định) hoặc `720p`
`server_id`	string	Không	Server tier, ví dụ: `vip1`, `vip2`, `fast`

Curl mẫu¶

curl -X POST https://ai.revidapi.com/v1/kol-ai/generate \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_id": "abc123",
    "audio_url": "https://cdn.revidapi.com/inputs/.../voice.wav",
    "image_url": "https://cdn.revidapi.com/inputs/.../photo.jpg",
    "quality": "1080p"
  }'

Kết quả trả về¶

{
  "job_id": "job_kol_123",
  "status": "pending"
}

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_kol_123" \
  -H "Authorization: Bearer sk_live_your_key"

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ì.