Skip to main content

​
Demo API Key

Want to explore the API first? Use the demo key to query sample tasks without signing up: 
zimg_demo_readonly_d2cb4bea56fcc21a9eb106e0
This key can only query pre-existing sample tasks — it has 0 credits and cannot create new videos. See Quickstart for sample task IDs.

​
Get Your API Key

  1. Sign up at kinovi.ai
  2. Go to Account → API Keys
  3. Create a new API key
  4. 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: 
Authorization: Bearer YOUR_API_KEY

​
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",
      "resolution": "1280x720",
      "duration": "5s"
    }
  }'

​
Authentication Errors

CodeMessageSolution
401Missing Authorization headerAdd the Authorization header
401Invalid API KeyCheck your API key
401API Key is inactiveReactivate in Account
401API Key has expiredGenerate a new key
403API access not enabled for this accountContact support to request developer access

​
Security Best Practices

  • Never expose API keys in client-side code or public repositories
  • Use environment variables to store keys
  • Rotate keys periodically
  • Create separate keys for development and production
# Store as environment variable
export SEEDANCE_API_KEY="your_api_key_here"

​
Next Steps

Quick Start

Generate your first video