KOL AI Generate

KOL AI Generate API¶

Overview¶

Generate KOL avatar video from uploaded image and audio.

Guide & Pricing¶

See dashboard, usage guide, and latest pricing at: app.revidapi.com

Authentication¶

Authorization: Bearer sk_live_your_key

1) Create KOL Job¶

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

Request parameters¶

Name	Type	Required	Description
`audio_id`	string	Yes	Uploaded audio ID
`audio_url`	string	Yes	Audio file URL
`image_url`	string	Yes	Character image URL
`prompt`	string	No	Optional extra prompt
`quality`	string	No	`1080p` (default) or `720p`
`server_id`	string	No	Server tier, e.g. `vip1`, `vip2`, `fast`

Curl example¶

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"
  }'

Create response example¶

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

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

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.