Long Video 生成 API

• Base URL：所有接口以 /v1 为前缀，生产环境 base 为你的部署域名（例 https://your-domain.com/v1/videos）。
• Content-Type：请求与响应均为 application/json。
• 流程：POST /v1/videos 创建任务 → 轮询 GET /v1/videos/{id} 或等待 Webhook → result_url 即成片。

在请求头携带 Authorization: Bearer sk-...。密钥以哈希存储，缺失、格式错误或未知/停用密钥统一返回 401 invalid_api_key。

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

创建任务时可携带 Idempotency-Key 请求头（建议用 UUID）。同一密钥 + 相同 key 的重复请求不会重复创建，而是直接返回已存在任务的 202。强烈建议在创建时带上，以避免网络重试导致重复扣费。

严格失败：任一分段失败会使整个任务转为 failed，未使用的 credits 自动退回。

回调请求体

{
  "task_id": "vid_abc",
  "status": "completed",
  "result_url": "https://.../final.mp4",
  "duration": 60,
  "cost_actual": 1650,
  "error": null,
  "metadata": { "user_ref": "..." }
}

重试：尽力而为，间隔 0 / 1s / 5s，三次仍失败即放弃。请同时用轮询 GET /v1/videos/{id} 兜底。

{ "error": { "code": "invalid_request", "message": "duration: Number must be ..." } }

• 计费单位为 credits。HappyHorse 费率：720p 27.5 / 秒，1080p 47.2 / 秒。
• cost_estimate：把 duration 按 ≤8s 分段，每段按 provider 费率计价后累加。例：60s × 720p ≈ 1650 credits。
• 创建任务即预扣 cost_estimate；任务失败自动退回未使用部分；取消按已完成分段结算后退回余额。
• 限制：duration 3–180 秒；单段 ≤8 秒。

1 · 创建任务并轮询（bash）

BASE="https://your-domain.com"
KEY="sk-..."

TASK=$(curl -s -X POST $BASE/v1/videos \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "城市清晨的延时风光", "duration": 30 }' | jq -r .task_id)

# 轮询直到 completed / failed
while true; do
  curl -s $BASE/v1/videos/$TASK -H "Authorization: Bearer $KEY" | jq '{status, progress, shots_done, shots_total, result_url}'
  sleep 5
done

2 · Node.js（fetch）

const BASE = 'https://your-domain.com';
const KEY = process.env.LONGVIDEO_KEY;

const res = await fetch(`${BASE}/v1/videos`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({ prompt: '城市清晨的延时风光', duration: 30 }),
});
const { task_id } = await res.json();

// 之后轮询 GET /v1/videos/${task_id}，或在 webhook_url 接收完成回调