车站 API 接入文档

接入前准备

1. 用户在车站网站填写图片验证码并注册、登录；车主或所属代理可为账户增加次数，用户也可兑换充值卡。
2. 在“账户 → API 密钥”创建密钥并立即保存；车主也可以在后台为已有用户创建。
3. 软件使用下面的地址和该用户的密钥请求接口。

接口地址：

这是车站自己的 HTTP 接口。其他软件需要支持下列请求格式，不能仅凭地址和密钥保证与所有软件兼容。密钥仅供本人使用，可在网站或车主后台随时撤销。

鉴权

除查看车辆外，请在每次请求中携带以下请求头之一：

Authorization: Bearer 用户自己的API密钥
X-API-Key: 用户自己的API密钥

JSON 请求使用 Content-Type: application/json。API 密钥可以提交、查询和取消本账户的任务、上传参考图及查看余额；管理账户和密钥需要登录网站。

1. 查看车辆和余额

GET /api/cars                     无需密钥
GET /api/user/me                  返回当前用户及 credits 余额

车辆返回 open 是否开放、cost 每段扣除的次数、models 和可用分辨率。滴滴专车的通道标识为 bailian，包车为 charter。每辆包车各自配置满多少条自动发车。

包车：选择车队并验证密码

GET /api/charter-fleets
POST /api/charter-fleets/{车队ID}/join
Authorization: Bearer 用户自己的API密钥
Content-Type: application/json

{"password":"车队密码"}

列表返回车队 ID、名称、候车数量和 autoThreshold。验证成功返回临时 ticket；提交包车任务时携带 fleetId 和 fleetTicket。凭证只属于当前账户和该车队，失效或服务器重启后重新验证。车队密码和临时凭证不要写进日志。

2. 上传参考图（可选）

POST /api/upload

使用 multipart/form-data 上传 file，或者直接发送图片二进制。支持 PNG、JPEG、WebP，单张不超过 20 MB；返回的 ref 或 url 可用于提交任务的 refs。

3. 任务上车

POST /api/jobs
Content-Type: application/json

{
  "car": "bailian",
  "prompt": "镜头缓慢推进，人物走到窗前。",
  "refs": [],
  "duration": 15,
  "ratio": "9:16",
  "resolution": "720P",
  "model": "wan3.0-video",
  "title": "第1段",
  "segmentNo": 1,
  "clientRef": "project-123-segment-1"
}

prompt 为必填；refs 最多 10 张，按数组顺序对应提示词中的 @image1、@image2。时长为 2–30 秒，具体模型与分辨率以车辆返回为准。

clientRef 建议使用本段任务的稳定唯一值；同一账户、同一车辆重复提交同一值会返回原任务，避免重复扣次。正常响应含 job.id、job.status 和剩余 credits。

segmentNo 可选，为该段在原文中的顺序（1–9999）。填写后用户在车站下载视频时，文件名会按该顺序编号；若未填写，车站仅在标题包含明确的“第 N 段”时使用该编号。

上车时扣除车站次数，任务初始为 pending。滴滴专车手动发车；包车由车主或代理配置该车密钥和自动发车数量，达到数量后自动发车，也可以手动发车。服务器可能产生渠道费用。

4. 查询或取消

GET    /api/jobs?limit=50        当前账户任务列表
GET    /api/jobs/{id}?refresh=1  查询单条任务和结果
DELETE /api/jobs/{id}            取消尚未发车的任务

状态依次可能为 pending、launching、submitted、running 和 done；完成后从 videoUrl 获取结果。明确失败为 failed，结果不确定为 unknown。

明确失败或成功取消候车任务会退回对应次数；结果未知时不要自动重复提交，请联系车主核对。建议每 15–30 秒查询一次。

错误状态

开发者示例

以下示例从环境变量读取用户密钥；请在自己的程序中配置，勿把真实密钥写入代码或公开链接。