在文本消息中附带图片、音频、视频或 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、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。