curl --request POST \
--url https://api.getinfinityblue.com/v1beta/models/{model}:generateContent \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"contents": [
{
"role": "user",
"parts": [
{
"text": "你好，请用一句话介绍 Gemini。"
}
]
}
]
}
'{
"candidates": [
{
"content": {
"role": "<string>",
"parts": [
{
"text": "<string>"
}
]
},
"finishReason": "<string>",
"safetyRatings": [
{
"category": "<string>",
"probability": "<string>"
}
]
}
],
"usageMetadata": {
"promptTokenCount": 123,
"candidatesTokenCount": 123,
"totalTokenCount": 123
}
}{
"error": {
"message": "无效的时长。支持的范围为 4 到 15 秒。",
"type": "invalid_request_error",
"param": "seconds",
"code": "invalid_duration"
}
}{
"error": {
"message": "无效的时长。支持的范围为 4 到 15 秒。",
"type": "invalid_request_error",
"param": "seconds",
"code": "invalid_duration"
}
}{
"error": {
"message": "无效的时长。支持的范围为 4 到 15 秒。",
"type": "invalid_request_error",
"param": "seconds",
"code": "invalid_duration"
}
}{
"error": {
"message": "无效的时长。支持的范围为 4 到 15 秒。",
"type": "invalid_request_error",
"param": "seconds",
"code": "invalid_duration"
}
}原生 Gemini 格式
Gemini 生成内容
以 Gemini 原生格式进行文本对话与图片 / PDF / 音频 / 视频识别
POST
/
v1beta
/
models
/
{model}
:generateContent
curl --request POST \
--url https://api.getinfinityblue.com/v1beta/models/{model}:generateContent \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"contents": [
{
"role": "user",
"parts": [
{
"text": "你好，请用一句话介绍 Gemini。"
}
]
}
]
}
'{
"candidates": [
{
"content": {
"role": "<string>",
"parts": [
{
"text": "<string>"
}
]
},
"finishReason": "<string>",
"safetyRatings": [
{
"category": "<string>",
"probability": "<string>"
}
]
}
],
"usageMetadata": {
"promptTokenCount": 123,
"candidatesTokenCount": 123,
"totalTokenCount": 123
}
}{
"error": {
"message": "无效的时长。支持的范围为 4 到 15 秒。",
"type": "invalid_request_error",
"param": "seconds",
"code": "invalid_duration"
}
}{
"error": {
"message": "无效的时长。支持的范围为 4 到 15 秒。",
"type": "invalid_request_error",
"param": "seconds",
"code": "invalid_duration"
}
}{
"error": {
"message": "无效的时长。支持的范围为 4 到 15 秒。",
"type": "invalid_request_error",
"param": "seconds",
"code": "invalid_duration"
}
}{
"error": {
"message": "无效的时长。支持的范围为 4 到 15 秒。",
"type": "invalid_request_error",
"param": "seconds",
"code": "invalid_duration"
}
}可填写的模型
| 模型 ID | 说明 |
|---|---|
gemini-3.1-pro-preview | Gemini 旗舰，强多模态，超长上下文 |
gemini-2.5-pro | 高性能多模态，支持百万 token 上下文 |
gemini-2.5-flash | 快速轻量版，适合高频调用 |
GET /v1/models。
多轮对话
在contents 数组中交替填写 role: user 和 role: model
的消息即可构成多轮对话。
媒体识别
在parts 中加入 inlineData 字段，提供 mimeType（如
image/jpeg、application/pdf、audio/mpeg、video/mp4）
和 base64 编码的文件数据。
流式输出
将路径中的:generateContent 改为 :streamGenerateContent?alt=sse
即可切换为 Server-Sent Events 流式模式。
安全过滤
通过safetySettings 数组调整各危害类别的过滤阈值。
系统指令
通过systemInstruction 字段传入系统级提示，格式与 contents
中的 parts 相同。授权
路径参数
模型名称，例如 gemini-2.5-pro、gemini-2.5-flash。
示例:
"gemini-2.5-pro"
请求体
application/json
Gemini generateContent 请求体，同时适用于文本对话与媒体识别。
对话内容数组，按时间顺序排列。每个元素包含 role（user 或 model）
和 parts（内容片段列表）。
Show child attributes
Show child attributes
生成参数配置。
Show child attributes
Show child attributes
安全过滤设置，可调整各危害类别的过滤阈值。
Show child attributes
Show child attributes
工具列表，用于函数调用（Function Calling）。
系统级指令，格式与 contents 中的元素相同。
Show child attributes
Show child attributes