请输入
菜单

Gemini 媒体识别

在文本消息中附带图片、音频、视频或 PDF,让支持对应模态的 Gemini 模型进行理解。

请求

项目 说明
方法 POST
路径 /v1beta/models/{model}:generateContent
网关地址 https://ailink.nativex.com
认证 Authorization: Bearer sk-xxxx,替换为你的 API Key
请求格式 application/json

示例中的 MODEL_ID 请替换为「模型广场」中支持本接口的模型名称。模型、参数支持范围与可用权限以当前账户为准。

参数说明

参数 位置 类型 必填 说明
model Path string 是 Gemini 模型名称
contents Body object[] 是 消息列表,每条含 role 与 parts;常用角色为 user、model
systemInstruction Body object 否 系统指令,使用 parts 提供内容
generationConfig Body object 否 生成设置,例如 temperature、topP、maxOutputTokens
safetySettings Body object[] 否 模型支持的安全设置
tools Body object[] 否 工具定义
contents[].parts[].inlineData Body object 否 mimeType 与 Base64 编码的 data
contents[].parts[].fileData Body object 否 mimeType 与可访问的 fileUri;和 inlineData 按需选用
请替换示例素材 URL。优先使用上游可公开访问的地址;Gemini File API 上传的私有 URI 受上游账户权限限制。

调用示例

curl -X POST 'https://ailink.nativex.com/v1beta/models/MODEL_ID:generateContent' \
  -H 'Authorization: Bearer sk-xxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "请描述这张图片。"
        },
        {
          "fileData": {
            "mimeType": "image/png",
            "fileUri": "https://example.com/input.png"
          }
        }
      ]
    }
  ]
}'

响应

以下为便于阅读的简化结构示例,标识、链接、文本及用量均为示意值。

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "你好!有什么可以帮助你?"
          }
        ]
      },
      "finishReason": "STOP"
    }
  ]
}
字段或结果 说明
candidates[].content.parts[].text 模型对素材的分析文本

错误处理

非成功响应时,先查看 HTTP 状态和错误正文。检查 API Key、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。

最近修改: 2026-10-28