Skip to main content
POST
/
api
/
v1
/
jobs
/
createTask
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 serene mountain landscape at golden hour, cinematic camera slowly panning right",
      "duration": "5",
      "aspectRatio": "16:9"
    }
  }'

{
  "taskId": "task_clxxxxxxxxxxxxxx"
}
Generate videos purely from text descriptions — no images needed.

​
How It Works

  1. You send a text prompt describing the video you want
  2. Seedance 2.0 generates a video (4–15 seconds) based on your description
  3. You poll the task status or receive a webhook when the video is ready

​
Pricing

​
Standard (seedance-20)

DurationCreditsPriceWith 4K Upscale
4s160$0.80272 credits ($1.36)
5s200$1.00340 credits ($1.70)
8s320$1.60544 credits ($2.72)
10s400$2.00680 credits ($3.40)
15s600$3.001020 credits ($5.10)

​
Fast (seedance2-fast)

DurationCreditsPriceWith 4K Upscale
4s112$0.56224 credits ($1.12)
5s140$0.70280 credits ($1.40)
8s224$1.12448 credits ($2.24)
10s280$1.40560 credits ($2.80)
15s420$2.10840 credits ($4.20)
Standard rate: 40 credits/sec. Fast rate: 28 credits/sec. 4K upscale: adds 28 credits/sec.1 credit = $0.005 (200 credits = $1).Fast mode generates videos ~2x faster with slightly reduced quality. Use seedance2-fast as the model value.

​
Authentication

Get API Key: API Key Management Page 
Authorization: Bearer YOUR_API_KEY

​
Parameters

ParameterTypeRequiredDescription
modelstringYesseedance-20 (standard) or seedance2-fast (faster, lower cost)
callBackUrlstringNoWebhook URL to receive task completion notification
inputsobjectYesGeneration parameters (see below)

​
inputs

ParameterTypeRequiredDescription
promptstringYesText description of the video you want to generate. Be specific about scenes, motions, camera movements, lighting, and style. Max 4000 characters.
durationstringNoVideo length in seconds: "4" to "15". Defaults to "5" if omitted. Directly affects cost (40 credits/sec standard, 28 credits/sec fast).
aspectRatiostringNoAspect ratio: 16:9, 9:16, 1:1, 3:4, 4:3, 21:9. Defaults to 16:9 for text-to-video.
modestringNokeyframe (default) — standard generation. reference — enables Omni Reference mode with multi-material support (images, videos, audio).
upscaleResolutionstringNoSet to 4k to upscale the output to 4K resolution. Adds 28 credits/sec to the base cost.

​
Prompt Tips

Write better prompts for better results:
  • Be specific about motion: “camera slowly panning right” is better than “moving camera”
  • Describe lighting and atmosphere: “golden hour warm light” vs just “daytime”
  • Include style keywords: “cinematic”, “documentary”, “anime”, “watercolor”
  • Mention camera angles: “low angle shot”, “aerial view”, “close-up”
  • Keep it concise: Focus on the key visual elements rather than writing a paragraph

​
Response

​
Status Values

StatusDescription
waitingTask queued, waiting to start
generatingVideo is being generated (typically 1–3 minutes)
successGeneration completed, video URL available in output
failGeneration failed, check error field for details

​
Error Codes

HTTP StatusDescriptionCommon Cause
200Success—
400Invalid parametersMissing prompt, invalid duration value
401Authentication failedInvalid or missing API key
402Insufficient creditsNot enough credits for the requested duration
429Concurrency limit exceededToo many tasks in progress, wait for some to complete
500Server errorInternal error, retry later
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 serene mountain landscape at golden hour, cinematic camera slowly panning right",
      "duration": "5",
      "aspectRatio": "16:9"
    }
  }'

{
  "taskId": "task_clxxxxxxxxxxxxxx"
}