Muxla 文档

外观

Veo 3.1 Fast 视频生成 ​

本文档说明 Muxla 兼容的 Gemini 视频生成接口：

text
POST /v1beta/models/veo-3.1-fast-generate-preview:generateContent

它的请求体风格与 Gemini generateContent 一致，使用 contents[].parts[] 传入内容。

请求地址 ​

text
POST https://mux.la/v1beta/models/veo-3.1-fast-generate-preview:generateContent

鉴权 ​

  • Muxla 网关：Authorization: Bearer sk-xxxxxxxxxxxx
  • Google 官方原生 Gemini API：通常使用 x-goog-api-key: $GEMINI_API_KEY

最小请求示例 ​

bash
curl "https://mux.la/v1beta/models/veo-3.1-fast-generate-preview:generateContent" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "A cinematic shot of a majestic lion in the savannah."
          }
        ]
      }
    ]
  }'

请求体结构 ​

json
{
  "contents": [
    {
      "parts": [
        {
          "text": "A cinematic shot of a majestic lion in the savannah."
        }
      ]
    }
  ]
}

常用请求字段 ​

字段必填说明
contents是输入内容数组
contents[].role否角色，常见为 user
contents[].parts是内容片段数组
parts[].text是视频生成提示词
parts[].inlineData否内联图片、音频或视频数据
parts[].fileData否文件引用
generationConfig否生成配置
safetySettings否安全过滤设置

示例 ​

纯文本提示词生成视频 ​

json
{
  "contents": [
    {
      "parts": [
        {
          "text": "A drone shot flying over snowy mountains at sunrise, cinematic, realistic lighting."
        }
      ]
    }
  ]
}

带参考图片 ​

json
{
  "contents": [
    {
      "parts": [
        {
          "text": "Animate this character walking through a neon-lit city street."
        },
        {
          "fileData": {
            "mimeType": "image/png",
            "fileUri": "https://example.com/reference.png"
          }
        }
      ]
    }
  ]
}

返回说明 ​

该接口虽然使用 generateContent 风格的请求体，但视频生成通常仍然按异步任务处理。

首次请求通常不会直接返回最终视频文件，而是先返回一个任务对象、操作对象，或者包含视频结果引用的响应。由于这是平台兼容接口，实际返回字段请以网关真实响应为准。

兼容任务返回示例 ​

json
{
  "id": "video_task_123",
  "object": "video.task",
  "model": "veo-3.1-fast-generate-preview",
  "status": "queued",
  "progress": 0,
  "created_at": 1712697600
}

完成示例 ​

json
{
  "id": "video_task_123",
  "object": "video.task",
  "model": "veo-3.1-fast-generate-preview",
  "status": "completed",
  "progress": 100,
  "created_at": 1712697600,
  "completed_at": 1712697815,
  "result": {
    "video_url": "https://example.com/output.mp4"
  }
}

与 Google 官方原生接口的差异 ​

Google 官方原生 Veo REST 示例可能使用 predictLongRunning 或其他长任务接口。Muxla 兼容接口以实际网关支持为准：

  • 请求入口：POST /v1beta/models/veo-3.1-fast-generate-preview:generateContent
  • 请求体结构：contents[].parts[].text
  • 结果类型：异步视频任务
  • 状态字段：status、progress
  • 成功结果：返回视频地址或文件引用