Skip to main content

​
Base URL

https://kinovi.ai/api/v1

​
Authentication

All endpoints require a Bearer token: 
Authorization: Bearer YOUR_API_KEY
See Authentication for details.

​
Endpoints

Text to Video

Generate video from text prompts

Image to Video

Generate video from images

Omni Reference

Visual references with @N syntax

Get Task Status

Check progress and retrieve results

Webhooks

Receive completion notifications via callback

​
Request Flow

1

Create Task

Submit a generation request with model and parameters
2

Receive Task ID

Get a unique task ID to track progress
3

Get Result

Poll task status every 3-5 seconds, or use webhooks to receive a callback when complete

​
Response Format

Success responses return data directly without a wrapper: 
{
  "taskId": "task_clxxxxxx"
}
Error responses return a message with the appropriate HTTP status code: 
{
  "message": "Invalid request parameters"
}

​
Error Codes

HTTP StatusMeaningCommon Causes
200SuccessRequest completed
400Bad RequestInvalid parameters
401UnauthorizedInvalid or missing API key
402Payment RequiredInsufficient credits
403ForbiddenAPI access not enabled
404Not FoundTask doesn’t exist
429Too Many RequestsConcurrency limit reached
500Server ErrorInternal error (retry)

​
Supported Model

Use seedance-20 as the model:
  • Text to Video — generate from text prompt. See Text to Video.
  • Image to Video — provide a source image, generate video. See Image to Video.
  • Omni Reference — use images/videos as visual references. See Omni Reference.
{
  "model": "seedance-20",
  "inputs": {
    "prompt": "...",
    "resolution": "1280x720",
    "duration": "5s"
  }
}

​
Credits

Rate5s10s15s
40 credits/sec200400600
See Pricing for details.

​
Support