Gemini 4 Argon

原生 Gemini 请求、多模态输入、思考、工具、流式响应和续写，以及当前验证范围。

通过原生 Gemini 格式使用 gemini-4-argon。模型页提供 Playground 和当前价格；发布指南介绍可用范围。

模型 ID

模型 ID	上下文窗口	默认强度
`gemini-4-argon`	1,048,576 token	`medium`

快速示例

curl https://api.seedrouter.ai/v1beta/models/gemini-4-argon:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Explain a mutex in one sentence."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"low"},"maxOutputTokens":256}}'

模型放在 URL 中，contents 为必填项。响应包含原生 candidates、finishReason 和 usageMetadata。请将完整的内容部分保存在对话历史中，包括 thoughtSignature。

端点

操作	端点
JSON 响应	`POST /v1beta/models/gemini-4-argon:generateContent`
服务器发送事件	`POST /v1beta/models/gemini-4-argon:streamGenerateContent?alt=sse`

OpenAPI 规范包含全部嵌套请求和响应 schema。省略可选字段时使用 API 默认值。未知字段和官方不支持的字段会被丢弃；支持字段的非法值仍会报错。

参数

名称	类型	必填	默认值	说明
`contents`	object[]	是	—	必填的对话数组；`parts` 承载文本、媒体和工具结果
`systemInstruction`	object	否	—	仅含文本的系统指令
`generationConfig`	object	否	—	输出预算、思考、结构化输出、停止条件和媒体设置
`tools`	object[]	否	—	函数和内置工具定义
`toolConfig`	object	否	—	函数选择、检索设置和服务器工具部分
`safetySettings`	object[]	否	—	不重复的安全类别与阈值配对
`continuationToken`	string	否	—	最新候选响应中的不透明续写 token
`serviceTier`	enum	否	`standard`	`unspecified`、`standard`、`flex`、`priority`；默认为 standard
`labels`	object	否	—	小写标签键和值，各不超过 63 个 Unicode 字符
`store`	boolean	否	—	请求日志偏好，不提供已存储对话的检索功能
`model`	string	否	—	可选的请求体资源名；模型由 URL 固定

generationConfig 包含 maxOutputTokens、thinkingConfig、stopSequences、responseFormat、旧版 responseMimeType/responseSchema/responseJsonSchema、responseModalities、mediaResolution、seed、presencePenalty、frequencyPenalty、responseLogprobs、logprobs、enableEnhancedCivicAnswers、enableAffectiveDialog、translationConfig 和 audioTranscriptionConfig。尚未确认模型专属行为的通用字段，仍需进行能力验证。

思考级别：low、medium、high，默认为 medium。思考无法关闭。includeThoughts 用于请求思考摘要。已弃用的 thinkingBudget 可单独使用，但不能与 thinkingLevel 同时设置。
输入、思考和输出共用 1,048,576 token。maxOutputTokens 包含思考 token；剩余上下文可能降低实际可用预算。
原生 REST 单次请求的输出上限和默认值为 32,768 token，流式为 65,536。更长的输出需通过续写完成。官方文档对首次非流式请求超过 32,768 的情况描述不一致；此接入不会将该数值作为整个生成过程的上限。
stopSequences 最多五项。logprobs 范围为 0 至 20，且要求 responseLogprobs: true。
responseSchema 与 responseJsonSchema 互斥，均要求 responseMimeType: "application/json"。新请求可使用下方的 responseFormat.text。
responseModalities 只能包含 TEXT。Temperature、top-p、top-k 和候选数量不是 Argon 的有效控制项。不支持显式 cachedContent、图片生成和语音生成。

结构化输出与工具

{
  "contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
  "generationConfig": {
    "thinkingConfig": {"thinkingLevel": "low"},
    "maxOutputTokens": 256,
    "responseFormat": {
      "text": {
        "mimeType": "APPLICATION_JSON",
        "schema": {"type": "object", "properties": {"ok": {"type": "boolean"}}, "required": ["ok"]}
      }
    }
  }
}

函数通过 tools[].functionDeclarations 定义。allowedFunctionNames 要求模式为 ANY 或 VALIDATED，且名称已声明。请保持函数调用、响应和签名的原始顺序。Google Search、Maps、代码执行、URL context、File Search 和 Computer Use 均为官方能力；资源访问、费用和实际行为需要针对预期操作进行验证。Playground 不会在本地执行工具。

媒体与安全设置

原生 parts 通过 inlineData 或 fileData 接受文本、图片、音频、视频和 PDF 输入。每个部分只包含一种内容类型，可附带思考签名和媒体元数据。全局 mediaResolution 与单个部分的分辨率设置不同。视频支持 STATIC 和 AGENTIC 处理；videoMetadata.fps 必须大于 0 且不超过 24。

Playground 接受最大 12 MiB 的 JSON 请求。这是应用传输限制，不是模型的媒体上限。大型媒体请使用账户支持的文件引用。文件资源与外部获取媒体的官方限制不同，此接入尚未验证其可用性。

公开 API 的安全设置遵循原生契约。Playground 要求四个主要安全类别使用中等或更严格的拦截设置；更低的阈值仅可通过 API 设置，管理员除外。

流式响应与续写

从 SSE 流读取原生 JSON 事件。保留全部内容部分，包括工具和思考元数据。同一流中的用量计数为累计值，请使用最后一个用量对象，不要逐个事件相加。

候选响应返回 continuationToken 时，请原样保留。对于 CONTINUATION，重新发送原始 contents、系统指令、工具和生成设置，并将最新 token 放在顶层。不要把部分输出追加到 contents。对于 MAX_TOKENS，恢复前需提高输出预算。Playground 会准备续写请求供你检查，仅在再次点击“发送”后才会提交。

每次续写都是独立请求，有独立的用量和费用。实现断线重连时请保留检查点，不要将连接中断视为已完成。Playground 会保留原生响应，供你检查全部字段。

用量与当前验证状态

输入用量包含缓存输入；计费输出包含候选响应和思考 token。请参阅模型页的当前费率及账户用量记录。失败的请求不收费。

2026 年 10 月 14 日的本地检查验证了文本流式生成、结构化 JSON、带签名的函数调用往返、代码执行、Google Search 和 URL context、图片/视频/PDF 理解、思考输出及停止序列。音频输入被接受，但样本中的部分内容转写有误。

logprobs 被明确拒绝。包含 maxOutputTokens: 32769 的请求在 JSON 和 SSE 检查中均失败。有效和无效的 continuationToken 都返回了答案，因此正确续写尚未验证。服务档位选项和 seed 被接受，但没有证据证明它们产生了效果。Maps、File Search、Computer Use、agentic video 及外部文件引用仍未测试。

这些有限的检查不能证明所有参数组合都有效，也不能证明生产环境的可用性。完整契约请使用原生格式；OpenAI 兼容格式是另一个功能子集，不提供 long decode。

参考资料

可选的 LLM 分组

登录当前模型的 Playground，即可确认支持哪些分组。可用选项取决于账户权限和所选模型。Playground 使用登录会话，无需提供 API key。

API 调用保持原有 API key 和 model ID。需要指定分组时，在可选请求头 X-SeedRouter-Group 中填写准确的分组名称。将下面的 GROUP_NAME 替换为 Playground 中显示的名称。不传该请求头或填写 auto 时，沿用该 key 的默认行为。

X-SeedRouter-Group: GROUP_NAME

受限 API key 可用的分组可能少于 Playground。请求按所选分组的价格计费；该分组不可用时，不会切换到其他分组。此选项支持 HTTP LLM 调用（包括 SSE），不适用于 WebSocket、图片或视频调用。

要查询某个 API key 可用的分组而不生成回答，可调用以下只读接口。data[].id 是请求头应填写的值；ratio 是该账户使用此分组的价格倍率。auto 项表示当前默认价格估算；没有可用默认分组时，其倍率为 null。实际调用模型时会再次检查分组是否可用。

curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-4-argon" \
  -H "Authorization: Bearer YOUR_SEEDROUTER_KEY"

On this page