典名词元典名词元首页
API 文档
AI 模型接口文本

文本生成(Gemini)

POST
/api/v1/v1beta/models/{model_name}:{action}

Path Parameters

model_name*string

模型名称,可选 gemini-2.5-pro gemini-2.5-flash gemini-2.5-flash-lite gemini-3-pro-preview gemini-3-flash-preview gemini-3.1-pro-preview gemini-3.1-flash-lite-preview

action*string

操作类型,支持generateContent非流式, streamGenerateContent流式返回

Header Parameters

Authorization*string

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

Request Body

application/json

tools?

是一段代码,可让系统与外部系统进行交互,以在模型知识和范围之外执行操作或一组操作。

contents*

对话消息数组(不包含 system 消息)

每条消息的 role 只能为 "user" 或 "assistant",且必须交替出现(第一条必须为 user)

generationConfig?
safetySettings?
systemInstruction?

Response Body

application/json

curl -X POST "https://api.aa.com.cn/api/v1/v1beta/models/string:string" \  -H "Authorization: string" \  -H "Content-Type: application/json" \  -d '{    "contents": [      {        "role": "system"      }    ]  }'
{
  "candidates": [
    {
      "content": {
        "role": "string",
        "parts": [
          {}
        ]
      },
      "finishReason": "string",
      "safetyRatings": [
        {}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 0,
    "candidatesTokenCount": 0,
    "totalTokenCount": 0
  }
}