任务:生成视频
概览
- 接口:任务:生成视频(POST /pika/generate)
- 说明:基于提示词及可选参考素材(图片/视频),生成短视频,支持可选音效参考与多项视频设置。
- 场景:pika 视频模型
认证
- 使用 Bearer Token(在请求头
Authorization: Bearer <token>中传入)。
请求参数
请求 Content-Type:
application/json请求体字段:
pikaffect(string, 可选)- 参考效果(音效)。可选值示例:
Ta-da、Deflate、Crumble、Dissolve、Squish、Inflate、Melt、Crush、Cake-ify、Explode。
- 参考效果(音效)。可选值示例:
promptText(string, 必填)- 提示词,用于描述要生成的视频内容。
model(string, 可选)- 模型版本,例如
1.5。
- 模型版本,例如
options(object, 必填)- 视频设置项,包含:
aspectRatio(number)- 宽高比(宽 / 高),例如 16:9 ≈ 1.7777777777777777。若要生成图片请移除该参数。
frameRate(integer, 默认 24)- 视频帧率。
camera(object)- 相机配置(可选,内部字段视实现而定)。
parameters(object, 必填)- 详细参数:
guidanceScale(integer)、motion(integer)、negativePrompt(string, 反向提示词,表示不希望出现的内容)。
- 详细参数:
extend(boolean, 必填)- 是否拓展模式(
false或true)。
- 是否拓展模式(
- 视频设置项,包含:
image(string, 可选)- 参考图片(Base64 或图片 URL)。若存在则需有值。
video(string, 可选)- 参考视频或扩展视频,若存在则需有值。
请求示例
bash
curl -X POST "https://api.gpt.ge/pika/generate" \
-H "Authorization: Bearer $YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"pikaffect": "Dissolve",
"promptText": "苹果蒸发",
"model": "1.5",
"options": {
"aspectRatio": 1.7777777777777777,
"frameRate": 24,
"camera": {},
"parameters": {
"guidanceScale": 12,
"motion": 1,
"negativePrompt": ""
},
"extend": false
}
}'请求体示例(JSON):
json
{
"pikaffect": "Dissolve",
"promptText": "苹果蒸发",
"model": "1.5",
"options": {
"aspectRatio": 1.7777777777777777,
"frameRate": 24,
"camera": {},
"parameters": {
"guidanceScale": 12,
"motion": 1,
"negativePrompt": ""
},
"extend": false
}
}成功响应示例
json
{
"id": "c8091b7b-06df-48ed-8fe3-8ee8f1e367c2"
}返回字段说明
id(string):任务 ID,用于后续调用查询接口获取任务状态与生成结果(视频地址等)。
说明
options.parameters.negativePrompt用于排除不希望出现的内容。- 若提供
image或video,请确保为可访问的 URL 或合法的 Base64 内容。 - 具体参数可根据后端实现细节调整,请以实际返回/错误信息为准。