文本模型进阶用户更新于
POST/v1beta/models/gemini-4-argon:generateContent
Gemini 4 Argon
请求 ID gemini-4-argon
协议
POST /v1beta/models/gemini-4-argon:generateContent· Gemini generateContent示例POST /v1beta/models/gemini-4-argon:streamGenerateContent· Gemini streamGenerateContent示例
认证
请求需要 API Key。在控制台的 API Key 管理 获取密钥。发送 JSON 请求时,设置 Content-Type: application/json。
- Gemini ·
x-goog-api-key: YOUR_API_KEY
请求参数
POST /v1beta/models/gemini-4-argon:generateContent
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
model (path) | string | 必填 | URL 路径中的模型 ID,填写 gemini-4-argon。 |
contents | object[] | 必填 | 按顺序排列的会话内容。每项使用 parts 保存输入片段。 |
contents[].role | string | 选填 | 消息角色。普通用户输入使用 user,模型历史消息使用 model。 |
contents[].parts | object[] | 必填 | 内容项中的片段数组。文本片段使用 text。 |
contents[].parts[].inlineData | object | 视条件 | 内联媒体对象。使用 mimeType 和 Base64 编码的 data。可用媒体类型取决于模型和接入点。 |
systemInstruction | object | 选填 | 系统指令对象。把指令文字放入 parts[].text。 |
generationConfig.maxOutputTokens | integer | 选填 | 输出 token 的上限。可用上限因模型和接入点而异。 |
generationConfig.responseMimeType | string | 选填 | 输出 MIME 类型。需要 JSON 时可填写 application/json。 |
generationConfig.responseJsonSchema | object | 视条件 | 输出 JSON Schema,与 responseMimeType: application/json 搭配使用。以所选接入点支持的能力为准。 |
tools | object[] | 视条件 | 供模型调用的工具定义。工具类型与参数格式以所选协议和接入点支持的能力为准。 |
POST /v1beta/models/gemini-4-argon:streamGenerateContent
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
model (path) | string | 必填 | URL 路径中的模型 ID,填写 gemini-4-argon。 |
contents | object[] | 必填 | 按顺序排列的会话内容。每项使用 parts 保存输入片段。 |
contents[].role | string | 选填 | 消息角色。普通用户输入使用 user,模型历史消息使用 model。 |
contents[].parts | object[] | 必填 | 内容项中的片段数组。文本片段使用 text。 |
contents[].parts[].inlineData | object | 视条件 | 内联媒体对象。使用 mimeType 和 Base64 编码的 data。可用媒体类型取决于模型和接入点。 |
systemInstruction | object | 选填 | 系统指令对象。把指令文字放入 parts[].text。 |
generationConfig.maxOutputTokens | integer | 选填 | 输出 token 的上限。可用上限因模型和接入点而异。 |
generationConfig.responseMimeType | string | 选填 | 输出 MIME 类型。需要 JSON 时可填写 application/json。 |
generationConfig.responseJsonSchema | object | 视条件 | 输出 JSON Schema,与 responseMimeType: application/json 搭配使用。以所选接入点支持的能力为准。 |
tools | object[] | 视条件 | 供模型调用的工具定义。工具类型与参数格式以所选协议和接入点支持的能力为准。 |
?alt | string | 选填 | 查询参数。填 sse 以 SSE 接收 streamGenerateContent 的结果。 |
请求示例
先将 API Key 设置为本机环境变量 ICODEEASY_API_KEY,并选择支持直接 HTTP 调用的接入点。接入点要求特定客户端时,按对应客户端指南配置。
Gemini generateContent
bash
curl -sS 'https://api.icodeeasy.cc/v1beta/models/gemini-4-argon:generateContent' \
-H "x-goog-api-key: $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Explain how a rainbow forms in one sentence."
}
]
}
]
}'
Gemini streamGenerateContent
bash
curl -N -sS 'https://api.icodeeasy.cc/v1beta/models/gemini-4-argon:streamGenerateContent?alt=sse' \
-H "x-goog-api-key: $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Explain how a rainbow forms in one sentence."
}
]
}
]
}'
读取响应
- Gemini generateContent · 从
candidates[].content.parts[]中读取文本片段。 JSON - Gemini streamGenerateContent · 逐条解析 SSE 数据,从
candidates[].content.parts[]拼接文本。 SSE
能力与限制
streaming· 支持tool_calling· 有条件支持 — 取决于兼容的协议与请求格式image_input· 有条件支持 — 取决于兼容的接入点与请求格式video_input· 有条件支持 — 取决于兼容的接入点与请求格式