Demo API Key
Want to explore the API first? Use the demo key to query sample tasks without signing up:
zimg_demo_readonly_d2cb4bea56fcc21a9eb106e0
Get Your API Key
- Sign up at kinovi.ai
- Go to Account → API Keys
- Create a new API key
- Copy and store it securely
API keys are shown only once. Store it immediately after creation.
Using Your API Key
Include the API key as a Bearer token in the Authorization header. Every request must include both headers:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Example
curl -X POST "https://kinovi.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-20",
"inputs": {
"prompt": "A beautiful sunset over the ocean",
"duration": "5",
"aspectRatio": "16:9"
}
}'
Authentication Errors
| Code | Message | Solution |
|---|
| 401 | Missing Authorization header | Add the Authorization header |
| 401 | Invalid API Key | Check your API key |
| 401 | API Key is inactive | Reactivate in Account |
| 401 | API Key has expired | Generate a new key |
| 403 | API access not enabled | Contact support to request developer access |
Rate Limits & Concurrency
| Limit | Value |
|---|
| Concurrent tasks | Up to 50 |
| Rate limit | Per account |
429. Rejected requests do not enter the queue and are not charged.
If you consistently hit limits, contact support to request a higher quota.
Data Retention
| Content | Retention |
|---|
| Generated media files | 14 days |
| Task logs & metadata | 60 days |
Security Best Practices
- Never expose API keys in client-side code or public repositories
- Use environment variables to store keys
- Rotate keys periodically via the API Keys dashboard
- Create separate keys for development and production
# Store as environment variable
export KINOVI_API_KEY="your_api_key_here"
