Seedance 2.5 API: access, pricing and code examples

Create a task

curl -X POST https://api.kie.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $KIE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2-5",
    "callBackUrl": "https://your-domain.com/api/seedance/callback",
    "input": {
      "prompt": "A ceramic artist lifts a cobalt bowl into window light, slow dolly in.",
      "resolution": "720p",
      "duration": 5,
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }'

Response

{ "code": 200, "msg": "success", "data": { "taskId": "task_bytedance_..." } }

Check the task

curl "https://api.kie.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $KIE_API_KEY"

Python with requests

import os, time, requests

BASE = "https://api.kie.ai/api/v1/jobs"
HEADERS = {"Authorization": f"Bearer {os.environ['KIE_API_KEY']}"}

def checked(response):
    response.raise_for_status()
    payload = response.json()
    if payload.get("code") != 200 or not payload.get("data"):
        raise RuntimeError("Provider rejected request; inspect server logs")
    return payload["data"]

created = checked(requests.post(f"{BASE}/createTask", headers=HEADERS, timeout=30, json={
    "model": "bytedance/seedance-2-5",
    "input": {"prompt": "A ceramic artist lifts a cobalt bowl, slow dolly in.",
              "resolution": "480p", "duration": 5, "aspect_ratio": "16:9"}
}))
task_id = created["taskId"]  # Persist before polling. Do not create a second task.
deadline = time.monotonic() + 20 * 60
while time.monotonic() < deadline:
    data = checked(requests.get(f"{BASE}/recordInfo", headers=HEADERS,
                   params={"taskId": task_id}, timeout=30))
    if data["state"] in ("success", "fail"):
        print(data["state"], data.get("resultJson") or data.get("failMsg"))
        break
    time.sleep(10)
else:
    print("Still running or unresolved; resume polling this task:", task_id)

Server-side JavaScript

import { fal } from '@fal-ai/client';

fal.config({ credentials: process.env.FAL_KEY });
const internalHashedUserId = process.env.FAL_END_USER_ID; // Stable non-personal account ID
if (!internalHashedUserId) throw new Error('Set FAL_END_USER_ID');

const result = await fal.subscribe(
  'bytedance/seedance-2.5/text-to-video',
  {
    input: {
      prompt: 'A ceramic artist lifts a cobalt bowl, slow dolly in.',
      duration: '10',
      resolution: '720p',
      aspect_ratio: '16:9',
      generate_audio: true,
      end_user_id: internalHashedUserId
    },
    logs: true
  }
);

const videoUrl = result.data.video.url;