Seedance 2.5 API実装ガイド：モデルID、Python、Node.js

seedance_route:
  owner: byteplus-ap
  base_url: https://ark.ap-southeast.bytepluses.com/api/v3
  secret_name: BYTEPLUS_ARK_API_KEY
  model_id: dreamina-seedance-2-0-260128
  create_path: /contents/generations/tasks
  status_path: /contents/generations/tasks/{id}
  delivery: callback-and-repair-polling

import os, time, requests

base = os.environ["SEEDANCE_BASE_URL"].rstrip("/")
headers = {"Authorization": f"Bearer {os.environ['SEEDANCE_API_KEY']}", "Content-Type": "application/json"}
payload = {
    "model": os.environ["SEEDANCE_MODEL"],
    "content": [{"type": "text", "text": "陶器のカップをゆっくり映すスタジオショット"}],
    "ratio": "16:9", "resolution": "720p", "duration": 5, "generate_audio": True,
}
r = requests.post(f"{base}/contents/generations/tasks", headers=headers, json=payload, timeout=30)
r.raise_for_status()
task_id = r.json()["id"]  # pollingより先に保存
while True:
    r = requests.get(f"{base}/contents/generations/tasks/{task_id}", headers=headers, timeout=30)
    r.raise_for_status()
    task = r.json()
    if task["status"] in {"succeeded", "failed", "expired"}:
        print(task)
        break
    time.sleep(5)

const base = process.env.SEEDANCE_BASE_URL.replace(/\/$/, "");
const headers = { Authorization: `Bearer ${process.env.SEEDANCE_API_KEY}`, "Content-Type": "application/json" };
async function call(path, init = {}) {
  const r = await fetch(`${base}${path}`, { ...init, headers: { ...headers, ...init.headers } });
  const type = r.headers.get("content-type") || "";
  if (!type.includes("application/json")) throw new Error(`JSONではなく${type}を受信`);
  const data = await r.json();
  if (!r.ok) throw new Error(`${r.status}: ${JSON.stringify(data)}`);
  return data;
}
const created = await call("/contents/generations/tasks", {
  method: "POST",
  body: JSON.stringify({ model: process.env.SEEDANCE_MODEL, content: [{ type: "text", text: "Slow studio shot of a ceramic cup" }], ratio: "16:9", resolution: "720p", duration: 5, generate_audio: true }),
});
const taskId = created.id; // polling前に永続化
for (;;) {
  const task = await call(`/contents/generations/tasks/${taskId}`);
  if (["succeeded", "failed", "expired"].includes(task.status)) { console.log(task); break; }
  await new Promise(resolve => setTimeout(resolve, 5000));
}

export ARK_API_KEY="replace-with-server-side-secret"

curl -X POST \
  "https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-260128",
    "content": [{
      "type": "text",
      "text": "A ceramic cup on a wooden desk, one slow camera move, soft morning light"
    }],
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": false,
    "priority": 3,
    "callback_url": "https://example.com/webhooks/seedance"
  }'

type SeedanceLedger = {
  jobId: string;
  route: "byteplus-ap" | "volcengine-cn" | "laozhang-relay";
  requestHash: string;
  providerTaskId?: string;
  state: "submitting" | "queued" | "running" | "succeeded" | "failed" | "expired";
  lastEventKey?: string;
  lastRawEvent?: unknown;
  storedResult?: string;
};

type ProviderTask = {
  id: string;
  status: "queued" | "running" | "succeeded" | "failed" | "expired";
};

const stateRank = { queued: 0, running: 1, succeeded: 2, failed: 2, expired: 2 } as const;
const terminalStates = new Set(["succeeded", "failed", "expired"]);

function canAdvance(current: SeedanceLedger["state"], next: ProviderTask["status"]) {
  if (terminalStates.has(current)) return false;
  const currentRank = current === "submitting" ? -1 : stateRank[current];
  return stateRank[next] >= currentRank;
}

async function reconcileCallback(event: ProviderTask) {
  const job = await ledger.findByProviderTaskId(event.id);
  if (!job) return new Response(null, { status: 404 });

  const eventKey = `${event.id}:${event.status}`;
  const applied = await ledger.transaction(job.jobId, async (current) => {
    if (current.lastEventKey === eventKey) return false;
    if (!canAdvance(current.state, event.status)) {
      await events.recordIgnored(current.jobId, event);
      return false;
    }
    await ledger.apply(current.jobId, {
      state: event.status,
      lastEventKey: eventKey,
      lastRawEvent: event,
    });
    return true;
  });

  if (applied && event.status === "succeeded") {
    await resultQueue.add(job.jobId);
  }
  return new Response(null, { status: 204 });
}

curl -X GET \
  "https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks/$TASK_ID" \
  -H "Authorization: Bearer $ARK_API_KEY"