API 文档

视频生成是异步接口。创建任务后保存 task_id，通过轮询或 WebHook 获取最终视频。

1. 查询视频模型

curl https://api.picccai.cn/v1/videos/models \
  -H "Authorization: Bearer $PICCC_API_KEY"

模型列表会返回分辨率、比例、时长范围、路由模式和参考模式。不同模型的可用值可能不同。

2. 创建文生视频任务

curl https://api.picccai.cn/v1/videos/tasks \
  -H "Authorization: Bearer $PICCC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_VIDEO_MODEL_ID",
    "prompt": "一只白色陶瓷杯缓慢旋转，柔和棚拍灯光，背景干净，镜头稳定",
    "route_mode": "text_to_video",
    "reference_mode": "text_to_video",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration_seconds": 6,
    "audio": false,
    "external_id": "video-job-10001"
  }'

请求字段

字段	必填	说明
model	是	GET /v1/videos/models 返回的模型 id。
prompt	是	视频描述，最多 4000 个字符。
route_mode	视模型而定	使用模型 route_modes 中的值。
reference_mode	视模型而定	使用模型 reference_modes 中的值。
resolution	否	使用 supported_resolutions 中的值。
aspect_ratio	否	使用 supported_aspect_ratios 中的值。
duration_seconds	否	时长需符合模型返回的 duration.min、duration.max 和 duration.step。
audio	否	是否生成音频，仅在模型支持时生效。
web_search	否	是否启用联网搜索，仅在模型支持时生效。
external_id	否	你的业务编号，最长 160 个字符。
webhook	否	任务完成后的回调配置。

创建成功

{
  "id": "oat_xxx",
  "task_id": "vtask_xxx",
  "type": "video",
  "status": "queued",
  "polling_url": "/v1/tasks/vtask_xxx",
  "created_at": 1783728000000
}

查询任务时使用 task_id。

参数选择建议

• 先用较短时长和较低分辨率验证提示词，再提交高成本任务。
• 请求参数以模型列表为准，不要把另一款模型的 route_mode 直接复制过来。
• 提示词里写清主体、动作、镜头和光线，比堆叠形容词更稳定。

积分扣费

任务创建时按模型定价、时长、分辨率、模式、音频和可选能力计算积分。积分不足会返回 402，任务不会进入队列。