岑城 AI · 开放接口
返回站点
服务端对接 · REST

参考生视频开放 API

用自己的后端提交参考生视频任务、查询生成结果。素材通过公网地址传入，积分从绑定的站点账号扣减，失败自动退回。

https://baas-api.website.xin/supabase/proxy/WS20261018201222000001/functions/v1/open-api快速开始

概览

两个接口完成一次生成：先创建任务，再按需轮询查询结果。

创建任务

POST /v1/tasks

提交素材与提示词，返回任务编号并预占积分。

查询任务

GET /v1/tasks/{task_id}

返回状态、成片地址与失败原因，成功即实扣、失败即退回。

  • · 仅支持服务端调用，请勿把 API Key 放进前端代码或浏览器请求。
  • · 建议每 5–10 秒查询一次任务，直到状态变为 succeeded 或 failed。
  • · 成片返回后请尽快转存，过期地址会失效。

模型能力

已接入参考生视频通道，按画质与时长分档；实际可用档位以提交时的任务校验为准。

参考生视频 · 标准

480P
输出 480P时长 5–15 秒

参考视频 1 条 · 人物图 1 张 · 背景图 / 商品图可选

按时长计费的基础档，适合批量试片与草稿迭代。

参考生视频 · 超清

1080P
输出 1080P时长 5–15 秒

参考视频 1 条 · 人物图 1 张 · 背景图 / 商品图可选

1080P 直出，无需二次放大，适合直接对外交付。

参考生视频 · 超清 15 秒档

1080P
输出 1080P时长 不超过 15 秒

参考视频 1 条 · 人物图 1 张 · 背景图 / 商品图可选

长时长优先的 1080P 档，提交时长越接近 15 秒越划算。

画质档位选择 2K 时，系统会按超清通道处理并返回高清成片；生成通道由站点自动调度，调用方无需指定。

鉴权

每个 Key 绑定一个站点账号，调用产生的积分从该账号扣减。

请求头
# 方式一：专用请求头
x-api-key: YOUR_API_KEY

# 方式二：Bearer 鉴权
Authorization: Bearer YOUR_API_KEY
Key 只在服务端保存与使用；泄露后请立即在后台停用并重新创建。

创建任务

POST /v1/tasks，返回任务编号与预占积分。

curl
curl -X POST "https://baas-api.website.xin/supabase/proxy/WS20261018201222000001/functions/v1/open-api/v1/tasks" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "严格复刻视频1 的镜头与动作，把视频1中的人物替换成图1中的人物",
    "ref_video_url": "https://your-cdn.com/reference.mp4",
    "person_image_url": "https://your-cdn.com/person.jpg",
    "duration_sec": 10,
    "resolution": "2K"
  }'

请求参数

字段类型必填说明
promptstring是生成提示词，最多 2000 字。素材引用统一写作 视频1、图1、图2。
ref_video_urlstring是参考视频地址，公网可直接下载，建议 mp4，时长不超过 15 秒。
person_image_urlstring是人物形象图地址，公网可直接访问的 jpg / png。
background_image_urlstring否背景图地址，需要在提示词中以 图2 引用时传入。
product_image_urlstring否商品或服饰图地址，需要在提示词中以 图3 引用时传入。
duration_secinteger否生成时长，5–15 的整数，默认 5。
resolutionstring否画质档位，480P 或 2K，默认 480P；2K 会在成片后处理为超清版本。

响应示例

201 Created
{
  "success": true,
  "task_id": "0f2c1f7e-8a45-4c65-9d3b-1f1a2c3d4e5f",
  "task_no": "GT20261108093000000001",
  "credits": 12,
  "status": "pending"
}

查询任务

GET /v1/tasks/{task_id}，查询时若仍在生成会同步刷新一次通道状态。

curl
curl "https://baas-api.website.xin/supabase/proxy/WS20261018201222000001/functions/v1/open-api/v1/tasks/0f2c1f7e-8a45-4c65-9d3b-1f1a2c3d4e5f" \
  -H "x-api-key: YOUR_API_KEY"

响应字段

  • task_id任务唯一编号，用于查询结果。
  • task_no可读任务号，便于人工核对。
  • status当前状态：pending / running / succeeded / failed。
  • result_video_url成片地址，成功后返回，建议尽快下载。
  • result_video_expires_at成片保留到期时间，过期后地址失效。
  • fail_reason失败原因，失败时返回，积分会全额退回。
  • credits本次任务预占或实扣的积分。
200 OK
{
  "success": true,
  "task_id": "0f2c1f7e-8a45-4c65-9d3b-1f1a2c3d4e5f",
  "task_no": "GT20261108093000000001",
  "status": "succeeded",
  "result_video_url": "https://cdn.example.com/result.mp4",
  "result_video_expires_at": "2026-11-09T09:30:00.000Z",
  "fail_reason": null,
  "credits": 12,
  "created_at": "2026-11-08T09:30:00.000Z",
  "finished_at": "2026-11-08T09:42:00.000Z"
}

错误与限流

统一返回 success、code、error；失败不影响任务结算，服务端异常不会扣积分。

状态码code说明
401unauthorizedAPI Key 缺失、无效或已停用。
400invalid_argument参数缺失或不在允许范围内，按 error 提示修正。
404not_found任务编号不存在或不属于当前 Key。
429rate_limited同一 Key 每分钟超过 60 次调用，稍后重试。
502provider_error生成通道临时不可用，预占积分已退回，可重试。
500internal_error服务内部异常，请稍后重试或联系客服。

调用频率

同一 Key 每分钟最多 60 次请求，超出返回 429，请退避后重试。

积分与退回

提交时预占积分，成功实扣；生成失败或通道异常自动全额退回。

接口能力与额度以站点后台配置为准 · 需要开通 Key 请联系站点运营