Seedance API reference

curl https://kreatorflow.ai/v1/videos \
  -H "Authorization: Bearer $KREATORFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: perfume-teaser-001" \
  -d '{
    "model": "kreator-video-seedance-2-5",
    "prompt": "slow dolly in on a glass perfume bottle on wet black stone, soft studio light, light rain",
    "duration": 5,
    "aspect_ratio": "9:16",
    "resolution": "720p"
  }'

# then poll until status is completed, failed, canceled or blocked
curl https://kreatorflow.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $KREATORFLOW_API_KEY"

import os, time, requests  # pip install requests

API = "https://kreatorflow.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['KREATORFLOW_API_KEY']}"}

job = requests.post(
    f"{API}/videos",
    headers={**HEADERS, "Idempotency-Key": "perfume-teaser-001"},
    json={
        "model": "kreator-video-seedance-2-5",
        "prompt": "slow dolly in on a glass perfume bottle on wet black stone, soft studio light, light rain",
        "duration": 5,
        "aspect_ratio": "9:16",
        "resolution": "720p",
    },
    timeout=60,
).json()["data"]["job"]

while job["status"] not in ("completed", "failed", "canceled", "blocked"):
    time.sleep(3)
    job = requests.get(f"{API}/jobs/{job['id']}", headers=HEADERS, timeout=60).json()["data"]["job"]

print(job["status"], job["providerOutputUrl"])

const API = "https://kreatorflow.ai/v1";
const headers = { Authorization: `Bearer ${process.env.KREATORFLOW_API_KEY}` };

let { data } = await fetch(`${API}/videos`, {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json", "Idempotency-Key": "perfume-teaser-001" },
  body: JSON.stringify({
    model: "kreator-video-seedance-2-5",
    prompt: "slow dolly in on a glass perfume bottle on wet black stone, soft studio light, light rain",
    duration: 5,
    aspect_ratio: "9:16",
    resolution: "720p",
  }),
}).then((response) => response.json());

let job = data.job;
while (!["completed", "failed", "canceled", "blocked"].includes(job.status)) {
  await new Promise((resolve) => setTimeout(resolve, 3000));
  ({ data } = await fetch(`${API}/jobs/${job.id}`, { headers }).then((response) => response.json()));
  job = data.job;
}

console.log(job.status, job.providerOutputUrl);

import { createHmac, timingSafeEqual } from "node:crypto";

// rawBody: the request body exactly as received (a string, before JSON.parse)
export function verifyKreatorFlowWebhook(rawBody, signatureHeader, secret) {
  const parts = Object.fromEntries(signatureHeader.split(",").map((part) => part.split("=")));
  const expected = createHmac("sha256", secret).update(`${parts.t}.${rawBody}`).digest("hex");
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300; // reject replays older than 5 min
  return fresh && expected.length === parts.v1?.length && timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1));
}

import hashlib, hmac, time

def verify_kreatorflow_webhook(raw_body: bytes, signature_header: str, secret: str) -> bool:
    parts = dict(part.split("=", 1) for part in signature_header.split(","))
    signed = f"{parts['t']}.".encode() + raw_body
    expected = hmac.new(secret.encode(), signed, hashlib.sha256).hexdigest()
    fresh = abs(time.time() - int(parts["t"])) < 300  # reject replays older than 5 min
    return fresh and hmac.compare_digest(expected, parts.get("v1", ""))