SeeAPI 客户接入文档

curl https://api.43.160.233.194.sslip.io/v1/video/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-20260510-0001" \
  -d '{
  "model": "seedance-2.0-face-video",
  "prompt": "生成一段自然柔光下的电影感真人肖像视频。",
  "face_reference_url": "https://example.com/assets/face.jpg",
  "image_reference_url": "https://example.com/assets/reference.jpg",
  "duration": 5,
  "aspect_ratio": "9:16",
  "callback_url": "https://client.example.com/webhooks/seeapi"
}'

curl https://api.43.160.233.194.sslip.io/v1/tasks/job_xxx \
  -H "Authorization: Bearer sk_live_xxx"

# 成功响应示例
{
  "id": "job_xxx",
  "object": "task",
  "status": "succeeded",
  "model": "seedance-2.0-face-video",
  "output": {
    "video_url": "https://cdn.example.com/users/usr_xxx/jobs/job_xxx/output/video.mp4",
    "assets": [
      {
        "type": "output_video",
        "url": "https://cdn.example.com/users/usr_xxx/jobs/job_xxx/output/video.mp4",
        "mime_type": "video/mp4",
        "size_bytes": "12345678",
        "checksum": "sha256:..."
      }
    ]
  },
  "error": null,
  "cost": {
    "estimated_units": 5000000,
    "charged_units": 5000000,
    "refunded_units": 0,
    "currency": "credits"
  },
  "created_at": "2026-05-10T08:00:00.000Z",
  "finished_at": "2026-05-10T08:01:00.000Z"
}

curl https://api.43.160.233.194.sslip.io/v1/models \
  -H "Authorization: Bearer sk_live_xxx"

# 响应示例
{
  "data": [
    {
      "code": "seedance-2.0-face-video",
      "modality": "video",
      "provider": "seedance",
      "execution_mode": "async",
      "status": "public",
      "input_schema": {
        "required": ["model", "prompt", "face_reference_url", "duration", "aspect_ratio"]
      },
      "pricing_rule": {
        "type": "fixed_by_duration",
        "currency": "credits"
      }
    }
  ]
}

curl https://api.43.160.233.194.sslip.io/v1/credits \
  -H "Authorization: Bearer sk_live_xxx"

# 响应示例
{
  "balance_units": 12000000,
  "currency": "credits",
  "paused_api_keys": 0
}

{
  "id": "evt_xxx",
  "type": "task.succeeded",
  "created_at": "2026-05-10T08:01:00.000Z",
  "data": {
    "id": "job_xxx",
    "status": "succeeded",
    "model": "seedance-2.0-face-video",
    "output": {
      "video_url": "https://cdn.example.com/users/usr_xxx/jobs/job_xxx/output/video.mp4"
    },
    "error": null
  }
}

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

const WEBHOOK_SECRET = process.env.SEEAPI_WEBHOOK_SECRET;

function verifySignature(rawBody, timestamp, signature) {
  if (!WEBHOOK_SECRET || !timestamp || !signature?.startsWith("v1=")) return false;

  const expected = "v1=" + createHmac("sha256", WEBHOOK_SECRET)
    .update(`${timestamp}.${rawBody}`)
    .digest("hex");

  const receivedBuffer = Buffer.from(signature);
  const expectedBuffer = Buffer.from(expected);
  return receivedBuffer.length === expectedBuffer.length
    && timingSafeEqual(receivedBuffer, expectedBuffer);
}

http.createServer((req, res) => {
  if (req.method !== "POST") {
    res.writeHead(405).end();
    return;
  }

  const chunks = [];
  req.on("data", (chunk) => chunks.push(chunk));
  req.on("end", () => {
    const rawBody = Buffer.concat(chunks).toString("utf8");
    const timestamp = req.headers["x-webhook-timestamp"];
    const signature = req.headers["x-webhook-signature"];

    if (!verifySignature(rawBody, String(timestamp ?? ""), String(signature ?? ""))) {
      res.writeHead(401).end("invalid signature");
      return;
    }

    const event = JSON.parse(rawBody);
    console.log(req.headers["x-webhook-id"], event.type, event.data.id);
    res.writeHead(204).end();
  });
}).listen(3000);

const BASE_URL = "https://api.43.160.233.194.sslip.io";
const API_KEY = process.env.SEEAPI_API_KEY;

async function main() {
  const submit = await fetch(`${BASE_URL}/v1/video/generations`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": "order-20260510-0001"
    },
    body: JSON.stringify({
      "model": "seedance-2.0-face-video",
      "prompt": "生成一段自然柔光下的电影感真人肖像视频。",
      "face_reference_url": "https://example.com/assets/face.jpg",
      "image_reference_url": "https://example.com/assets/reference.jpg",
      "duration": 5,
      "aspect_ratio": "9:16",
      "callback_url": "https://client.example.com/webhooks/seeapi"
})
  });

  const task = await submit.json();
  if (!submit.ok) throw new Error(JSON.stringify(task));

  while (true) {
    const res = await fetch(`${BASE_URL}/v1/tasks/${task.id}`, {
      headers: { Authorization: `Bearer ${API_KEY}` }
    });
    const current = await res.json();
    if (!res.ok) throw new Error(JSON.stringify(current));

    if (["succeeded", "refunded", "failed", "canceled"].includes(current.status)) {
      console.log(current);
      return;
    }
    await new Promise((resolve) => setTimeout(resolve, 3000));
  }
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

import os
import time
import requests

BASE_URL = "https://api.43.160.233.194.sslip.io"
API_KEY = os.environ["SEEAPI_API_KEY"]

payload = {
  "model": "seedance-2.0-face-video",
  "prompt": "生成一段自然柔光下的电影感真人肖像视频。",
  "face_reference_url": "https://example.com/assets/face.jpg",
  "image_reference_url": "https://example.com/assets/reference.jpg",
  "duration": 5,
  "aspect_ratio": "9:16",
  "callback_url": "https://client.example.com/webhooks/seeapi"
}

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
    "Idempotency-Key": "order-20260510-0001",
}

submit = requests.post(f"{BASE_URL}/v1/video/generations", json=payload, headers=headers, timeout=30)
submit.raise_for_status()
task = submit.json()

while True:
    res = requests.get(
        f"{BASE_URL}/v1/tasks/{task['id']}",
        headers={"Authorization": f"Bearer {API_KEY}"},
        timeout=30,
    )
    res.raise_for_status()
    current = res.json()
    if current["status"] in ["succeeded", "refunded", "failed", "canceled"]:
        print(current)
        break
    time.sleep(3)