Skip to content

任务:生成视频

概览

  • 接口:任务:生成视频(POST /pika/generate)
  • 说明:基于提示词及可选参考素材(图片/视频),生成短视频,支持可选音效参考与多项视频设置。
  • 场景:pika 视频模型

认证

  • 使用 Bearer Token(在请求头 Authorization: Bearer <token> 中传入)。

请求参数

  • 请求 Content-Type:application/json

  • 请求体字段:

    • pikaffect (string, 可选)

      • 参考效果(音效)。可选值示例:Ta-daDeflateCrumbleDissolveSquishInflateMeltCrushCake-ifyExplode
    • 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, 必填)
          • 是否拓展模式(falsetrue)。
    • 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 用于排除不希望出现的内容。
  • 若提供 imagevideo,请确保为可访问的 URL 或合法的 Base64 内容。
  • 具体参数可根据后端实现细节调整,请以实际返回/错误信息为准。