格式化输出

POST

/v1beta/models/gemini-2.5-pro:generateContent

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

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

Body Params application/json

Example

{
  "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"
        ]
      }
    }
  }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff '/v1beta/models/gemini-2.5-pro:generateContent?key=' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "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"
        ]
      }
    }
  }
}'

Responses

🟢200成功

application/json

Bodyapplication/json

Example

{}

Modified at 2026-03-30 11:39:32

图片理解

函数调用