Chat Completions

接口说明

该接口兼容 OpenAI Chat Completions 风格，适合“文本 + 图片输入 -> 文本输出”的多模态场景。

端点与方法

POST /v1/chat/completions

请求参数

• model：模型名称
• messages：消息数组
• messages[].content[]：多模态内容项
• max_tokens：最大输出长度
• temperature：采样温度
• seed：可选随机种子

完整请求示例

{
  "model": "gemini-3-pro-preview-c",
  "messages": [
    {
      "role": "system",
      "content": [
        {
          "type": "text",
          "text": "你是一名专业的图像描述助手，请根据用户输入详细描述图片中的主体、背景和风格。"
        }
      ]
    },
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "请用中文详细描述这组图的主体、材质、光线、背景与风格，并给出适合用于生图的提示词关键词。"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/jpeg;base64,<BASE64_IMAGE_1>"
          }
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/jpeg;base64,<BASE64_IMAGE_2>"
          }
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,<BASE64_IMAGE_3>"
          }
        }
      ]
    }
  ],
  "max_tokens": 1024,
  "temperature": 0.7,
  "seed": 20250101
}

返回解析

优先读取：

choices[0].message.content

兼容处理建议：

• 若是字符串，直接作为最终文本
• 若是数组，拼接其中 type=text 的 text

常见报错

• 把 content 错写成单个对象而不是数组
• 图片数量超出限制
• 图片 base64 未带 data:image/...;base64, 前缀

下一步

• 提示词设计
• 图片输入建议