Skip to content

格式化输出

POST https://az.gptplus5.com/v1beta/models/gemini-2.5-pro:generateContent

官方文档:https://ai.google.dev/gemini-api/docs/structured-output?hl=zh-cn

请求参数

Authorization

在 Header 添加参数Authorization,其值为在 Bearer 之后拼接 Token

示例:Authorization: Bearer ********************

Query 参数

参数名类型必需说明示例
keystring必需{{YOUR_API_KEY}}

Header 参数

参数名类型必需说明示例
Content-Typestring必需application/json

Body 参数 (application/json)

参数名类型必需说明
contentsarray[object]必需
  └ partsarray[object]可选
generationConfigobject必需
  └ responseModalitiesarray[string]必需

请求示例

json
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "List a few popular cookie recipes, and include the amounts of ingredients."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseMimeType": "application/json",
    "responseSchema": {
      "type": "ARRAY",
      "items": {
        "type": "OBJECT",
        "properties": {
          "recipeName": {
            "type": "STRING"
          },
          "ingredients": {
            "type": "ARRAY",
            "items": {
              "type": "STRING"
            }
          }
        },
        "propertyOrdering": [
          "recipeName",
          "ingredients"
        ]
      }
    }
  }
}

cURL 示例

bash
curl --location -g --request POST 'https://az.gptplus5.com/v1beta/models/gemini-2.5-pro:generateContent?key=' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "List a few popular cookie recipes, and include the amounts of ingredients."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseMimeType": "application/json",
    "responseSchema": {
      "type": "ARRAY",
      "items": {
        "type": "OBJECT",
        "properties": {
          "recipeName": {
            "type": "STRING"
          },
          "ingredients": {
            "type": "ARRAY",
            "items": {
              "type": "STRING"
            }
          }
        },
        "propertyOrdering": [
          "recipeName",
          "ingredients"
        ]
      }
    }
  }
}'

返回响应

🟢200成功

响应示例

json
{}