Welcome to Kinovi — a unified API for AI video and image generation. One endpoint, multiple models, simple async flow.
1. Create Your API Key
Sign up at kinovi.ai
Go to API Keys and create a key
Add credits to your account
export KINOVI_API_KEY = "your_api_key_here"
No API key yet? Try the Playground first — no code needed.
2. Make Your First Request
All models use the same endpoint: POST /jobs/createTask. Just change model and inputs:
Video (Seedance 2.0)
Image (Midjourney)
Image (NanoBanana 2)
curl -X POST "https://kinovi.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $KINOVI_API_KEY " \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-20",
"inputs": {
"prompt": "A serene Japanese garden with cherry blossoms swaying in the wind",
"duration": "5",
"aspectRatio": "16:9"
}
}'
curl -X POST "https://kinovi.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $KINOVI_API_KEY " \
-H "Content-Type: application/json" \
-d '{
"model": "midjourney-v7",
"inputs": {
"prompt": "A majestic snow leopard on a mountain cliff at golden hour, hyperrealistic",
"aspectRatio": "16:9"
}
}'
curl -X POST "https://kinovi.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $KINOVI_API_KEY " \
-H "Content-Type: application/json" \
-d '{
"model": "nanobanana2",
"inputs": {
"prompt": "A futuristic cityscape at sunset, ultra detailed",
"resolution": "2k"
}
}'
Returns:
{ "taskId" : "task_clxxxxxx" }
A 200 response means the task was created , not completed. You need to poll for the result.
3. Get Your Result
Poll every 3–5 seconds until status is success or fail:
curl -s "https://kinovi.ai/api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID" \
-H "Authorization: Bearer $KINOVI_API_KEY "
Success response:
{
"taskId" : "task_clxxxxxx" ,
"status" : "success" ,
"output" : [{ "url" : "https://..../result.mp4" , "width" : 1280 , "height" : 720 }],
"creditsUsed" : 200
}
That’s it — create task → poll status → get output URL . Same flow for every model.
Next Steps
Available Models See all supported video and image models
Authentication API key, headers, rate limits, and security
Live Demo Copy-paste scripts to test the API instantly
Playground Generate in the browser — no code needed