API 文档

生成视频

POST /v1/video/generations

提交出片任务。异步返回：提交即拿 task_id，出片一般要 1~5 分钟，具体取决于模型、时长与分辨率。路径与返回形状对齐 new-api 的视频渠道，可直接挂到中转网关上当视频通道用。

请求参数

参数类型说明
promptstring必填。视频描述
modelstring模型 id，取自 /v1/models。不传用平台默认
modestringtext=文生视频（默认）| image=图生视频
durationinteger时长秒数。会被夹到所选规格档的 min_sec ~ max_sec
resolutionstring480p | 720p | 1080p | 4k。传了 spec 时以规格档为准
ratiostringadaptive | landscape | portrait | 16:9 | 9:16 | 4:3 | 3:4 | 1:1 | 21:9。不传则按 width/height 推横竖，都没有就是 adaptive；传了这几个以外的值会直接报错。所选模型支持其中哪几个见 /v1/models 的 aspect_ratios
width / heightinteger像素写法，仅在没传 ratio 时用来定横竖。宽高相等按 adaptive 处理
specstring规格档位键，决定分辨率与每秒单价
imagestring首帧图地址。mode=image 时使用
image_laststring尾帧图地址。与 image 搭配即首尾帧模式
reference_imagesstring[]参考图地址，用于保持主体一致性
reference_videosstring[]参考视频公网地址；与 reference_video_durations 按下标一一对应
reference_video_durationsnumber[]各参考视频的时长（秒）；必须是可探测的正数
reference_audiosstring[]参考音频公网地址；与 reference_audio_durations 按下标一一对应
reference_audio_durationsnumber[]各参考音频的时长（秒）；必须是可探测的正数
mode=image 时，image 与 reference_images 至少要给一个，两个都空会直接报错。参考视频与音频按模型能力开放；所选规格 reference_media_max_sec>0 时，每段相关媒体都必须提交可探测的正数时长，参考视频按秒计价时也必须提交 reference_video_durations。不支持或超限会明确拒绝。n 大于 1 同样直接报错：出片按条计费、按条限并发，请分多次提交。

请求示例

bash
curl https://open.pikpikgo.com/v1/video/generations \
  -H "Authorization: Bearer $PIKPIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "镜头缓慢推进，少女回头微笑",
    "mode": "text",
    "duration": 5,
    "resolution": "720p"
  }'

返回示例

json
{
  "task_id": "2608101915300490318827",
  "id": "2608101915300490318827",
  "object": "video",
  "model": "video-pro-1",
  "created_at": 1786000530,
  "status": "processing",
  "url": "",
  "format": "",
  "metadata": {
    "duration": 5,
    "resolution": "720p",
    "ratio": "adaptive"
  },
  "error": null,
  "credits": 60,
  "prompt": "镜头缓慢推进，少女回头微笑"
}

status 为 processing 表示已提交给渲染方，用返回的 task_id 去下面的查询端点轮询即可。出片失败时算力会自动退还。

查询出片任务

GET /v1/video/generations/{task_id} —— 出片任务走这个端点轮询，不是 /v1/tasks/{id}（那个只服务出图）。返回结构与提交时一致，完成后 url 是成片地址、format 是容器格式。

bash
curl https://open.pikpikgo.com/v1/video/generations/2608101915300490318827 \
  -H "Authorization: Bearer $PIKPIK_API_KEY"
json
{
  "task_id": "2608101915300490318827",
  "id": "2608101915300490318827",
  "object": "video",
  "model": "video-pro-1",
  "created_at": 1786000530,
  "status": "succeeded",
  "url": "https://cdn.pikpikgo.com/video/2608101915300490318827.mp4",
  "format": "mp4",
  "metadata": {
    "duration": 5,
    "resolution": "720p",
    "ratio": "adaptive"
  },
  "error": null,
  "credits": 60,
  "prompt": "镜头缓慢推进，少女回头微笑"
}
error 在成功时是 null 而不是空串，判失败请用 status 或 error !== null。任务只能被创建它的那个账号查询，查别人的与查不存在的返回完全一样的 404。