功能指南

视频生成

视频与图片一样是异步任务，API Key 需要「视频生成」权限。

1. 选模型与参数

GET /v1/models?type=video 返回全部视频模型。每个模型的 mode 决定需要什么输入：

mode	需要
`text-to-video`	只要 `prompt`
`image-to-video`	`imageKey`（首帧）
`reference-to-video`	`referenceImageKeys`
`video-extend`、`video-edit`	`videoKey` 或 `sourceJobId`（源视频）

duration、resolution、aspectRatio 必须取该模型 durations、resolutions、aspectRatios 里的值，原样照抄，例如时长写 "5s" 而不是 "5"。

2. 提交

curl -s -X POST https://sichang.xyz/api/v1/videos \
  -H "Authorization: Bearer $SICHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "<模型 id>", "prompt": "清晨的湖面，薄雾缓缓散开，一只白鹭掠过水面",
       "duration": "5s", "resolution": "480p", "aspectRatio": "16:9"}'

图片、音频、视频素材先用 POST /v1/uploads（target 填 video）上传，拿到的 key 填进 imageKey 等字段。

3. 拿结果

与图片相同：GET /v1/jobs/{id}?wait=30 长轮询到 COMPLETED，outputs[].downloadUrl 15 分钟内有效。实测 5 秒 480p 约 1 分钟出片，不同模型差别很大。

价格

视频模型与模型目录里的 pricingCredits 是估价（基础积分 + 每秒积分 × 秒数）。实际扣费以提交时的报价为准，看响应里的 credits.charged，可能与估价有几积分的出入。失败自动全额退款。