generate (文生视频\图生视频\视频生视频)

OpenAPI Specification

Pika 兼容路径的多形态生成接口：同一入口支持文生视频、图生视频与视频生视频，按是否携带参考素材自动区分。

请求方式：POST

接口地址

text

https://api.allyang.cn/pika/generate

请求头

User-Agent（必填）：（示例：curl/8.5.0）
Content-Type（必填）：请求体类型，按本页标注填写。（示例：application/json）
Authorization（可选）：鉴权头，使用控制台创建的令牌，格式为 Bearer + 令牌。（示例：Bearer {{YOUR_API_KEY}}）

请求参数（application/json）

pikaffect（string，必填）：视频特效模板，可留空；命中特效后会带配音。当前可选：Ta-da、Deflate、Crumble、Dissolve、Squish、Inflate、Melt、Crush、Cake-ify、Explode（后续可能新增，以实测为准）。
promptText（string，必填）：提示词文本。
model（string，必填）：模型版本，可选 1.5 或 2.0。
options（object，必填）：视频相关设置集合。
- aspectRatio（number，必填）：画面宽高比；传入图片时不要携带本字段。
- frameRate（integer，必填）：缺省 24。
- camera（object，必填）：缺省为空对象 {}。
- parameters（object，必填）
  - guidanceScale（integer，必填）
  - motion（integer，必填）
  - negativePrompt（string，必填）：需要从画面中移除的物体。
- extend（boolean，必填）
image（string，可选）：存在时必须有值，支持 base64 或图片 URL。
video（string，可选）：参考或待扩展的视频，存在时必须有值。

请求示例

json

{
  "pikaffect": "Ta-da",
  "options": {
    "aspectRatio": null,
    "frameRate": "24",
    "camera": {},
    "parameters": {
      "guidanceScale": null,
      "motion": null,
      "negativePrompt": null
    },
    "extend": null
  }
}

返回：HTTP 200 表示成功，响应体字段待补（以实测为准）。

使用提示：不携带参考素材即按文生视频处理；比例、时长等取值以参数说明为准。