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
contents*array<object>
对话消息数组（不包含 system 消息）
每条消息的 role 只能为 "user" 或 "assistant"，且必须交替出现（第一条必须为 user）
[]?object
role*string
Value in"user" | "model"
Value in
"model" | "user" | "assistant" | "tool"parts?array<object>
构成单条消息的有序 Parts。部分可能具有不同的 MIME 类型
[]?object
text?string
内嵌文本。
inlineData?object
内嵌媒体字节。
mimeType?string
来源数据的 IANA 标准 MIME 类型。示例： - image/png - image/jpeg 如果提供的 MIME 类型不受支持，系统会返回错误。
data?string
媒体格式的原始字节。
使用 base64 编码的字符串。
generationConfig?object
temperature?number
topP?number
topK?number
maxOutputTokens?integer
stopSequences?array<string>
[]?string
safetySettings?array<object>
[]?object
category?string
threshold?string
tools?array<object>
是一段代码，可让系统与外部系统进行交互，以在模型知识和范围之外执行操作或一组操作。
[]?object
systemInstruction?object
parts?array<object>
[]?object
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": "model", "parts": [ { "text": "string", "inlineData": { "mimeType": "string", "data": "string" } } ] } ], "generationConfig": { "temperature": 0, "topP": 0, "topK": 0, "maxOutputTokens": 0, "stopSequences": [ "string" ] }, "safetySettings": [ { "category": "string", "threshold": "string" } ], "tools": [ {} ], "systemInstruction": { "parts": [ {} ] } }'{
"candidates": [
{
"content": {
"role": "string",
"parts": [
{}
]
},
"finishReason": "string",
"safetyRatings": [
{}
]
}
],
"usageMetadata": {
"promptTokenCount": 0,
"candidatesTokenCount": 0,
"totalTokenCount": 0
}
}