Seedance 真人素材 API

# 1) Volcengine sends the person's browser to YingTu's relay URL
GET https://yingtu.ai/api/seedance-assets/real-persons/callback/cb_...?bytedToken=...&resultCode=10000

# 2) YingTu answers with a redirect to your callback_url
HTTP/1.1 302 Found
Location: https://app.example.com/seedance/verified?user=42&verification_id=ver_Zp7cM1xRa4...Ty9vB&result_code=10000

HTTP/1.1 400 Bad Request
Content-Type: application/json
Cache-Control: no-store
X-Request-Id: req_42480b1cfd2147439b8c514ad8688ab0

{
  "error": {
    "code": "invalid_request",
    "message": "Unknown request field: consent_reference.",
    "request_id": "req_42480b1cfd2147439b8c514ad8688ab0",
    "retryable": false
  }
}

X-Request-Id: req_4f0c2a9e8b7d4c1fa3e56b7d9c0e1f2a
X-RateLimit-Limit: 12
X-RateLimit-Remaining: 11
X-RateLimit-Reset: 1790326800

curl -X POST https://api.laozhang.ai/seedance/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast-260128",
    "content": [
      { "type": "text", "text": "参考图中的角色在雨夜的霓虹街头慢慢走向镜头，电影感光影" },
      {
        "type": "image_url",
        "image_url": { "url": "asset://asset-20260925080012-x7k2p" },
        "role": "reference_image"
      }
    ],
    "ratio": "16:9",
    "duration": 5,
    "resolution": "720p",
    "watermark": false,
    "generate_audio": false
  }'

import os
import time

import requests

BASE_URL = "https://yingtu.ai/api/seedance-assets"
HEADERS = {"Authorization": f"Bearer {os.environ['LAOZHANG_API_KEY']}"}


def api(method, path, **kwargs):
    resp = requests.request(method, BASE_URL + path, headers=HEADERS, timeout=60, **kwargs)
    body = resp.json()
    if not resp.ok:
        err = body["error"]
        raise RuntimeError(f"{resp.status_code} {err['code']}: {err['message']} ({err['request_id']})")
    return body


# 1. 创建认证会话。callback_url 上可以带你自己的参数，回跳时原样保留
session = api("POST", "/real-persons/verifications", json={
    "callback_url": "https://app.example.com/seedance/verified?user=42",
    "language": "zh",
})
verification_id = session["verification_id"]  # 存到你的数据库，和 user=42 关联
print("把这个链接发给本人：", session["verification_url"])

# 2. 等本人完成认证。可以在回调页被打开时触发，也可以直接轮询；
#    过期后会抛出 410 verification_expired
while api("GET", f"/real-persons/verifications/{verification_id}")["status"] != "verified":
    time.sleep(5)

# 3. 用本人的清晰正面照创建素材
asset = api("POST", "/real-persons", json={
    "verification_id": verification_id,
    "image_url": "https://cdn.example.com/people/presenter-a.jpg",
    "name": "presenter-a",
})

# 4. 等素材可用
for _ in range(120):
    if asset["status"] in ("Active", "Failed"):
        break
    time.sleep(5)
    asset = api("GET", f"/real-persons/{asset['id']}")
print(asset["status"], asset["uri"], asset.get("failure"))

// Node.js 18+，保存为 real-person.mjs 后运行：node real-person.mjs
const BASE_URL = "https://yingtu.ai/api/seedance-assets";
const AUTH = { Authorization: "Bearer " + process.env.LAOZHANG_API_KEY };
const JSON_HEADERS = { "Content-Type": "application/json" };
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function api(path, init = {}) {
  const res = await fetch(BASE_URL + path, {
    ...init,
    headers: { ...AUTH, ...init.headers },
    signal: AbortSignal.timeout(60_000),
  });
  const body = await res.json();
  if (!res.ok) {
    const { code, message, request_id } = body.error;
    throw new Error(res.status + " " + code + ": " + message + " (" + request_id + ")");
  }
  return body;
}

// 1. 创建认证会话；callback_url 上你自己的参数会原样带回
const session = await api("/real-persons/verifications", {
  method: "POST",
  headers: JSON_HEADERS,
  body: JSON.stringify({
    callback_url: "https://app.example.com/seedance/verified?user=42",
    language: "zh",
  }),
});
const verificationId = session.verification_id; // 存到你的数据库，和 user=42 关联
console.log("把这个链接发给本人：", session.verification_url);

// 2. 等本人完成认证；过期后会抛出 410 verification_expired
while ((await api("/real-persons/verifications/" + verificationId)).status !== "verified") {
  await sleep(5000);
}

// 3. 用本人的清晰正面照创建素材
let asset = await api("/real-persons", {
  method: "POST",
  headers: JSON_HEADERS,
  body: JSON.stringify({
    verification_id: verificationId,
    image_url: "https://cdn.example.com/people/presenter-a.jpg",
    name: "presenter-a",
  }),
});

// 4. 等素材可用
for (let i = 0; i < 120 && !["Active", "Failed"].includes(asset.status); i++) {
  await sleep(5000);
  asset = await api("/real-persons/" + asset.id);
}
console.log(asset.status, asset.uri, asset.failure);