Claude Opus 5.5 已在 SeedRouter 上线

Text

Gemini 4 Neon

View Markdown

原生 Gemini 请求、四档思考级别、使用续写 token 的长文本分段生成、工具、多模态输入和流式响应。包含模型限制与验证状态。

以原生 Gemini 格式使用 gemini-4-neon。模型页面提供 Playground 和当前价格。Gemini 4 Neon 定位介于 Gemini 4 Hydrogen 与 Gemini 4 Carbon 之间,并使用相同的原生 generateContent 请求格式;Google 迁移指南指出,在 Gemini 4 模型之间切换无需更改请求 schema。

模型 ID

模型 ID上下文窗口默认思考级别
gemini-4-neon1,048,576 token,由输入、思考和输出共用high

Default 档位请使用 gemini-4-neon,或选择模型发现接口返回的显式 gemini-4-neon:GROUP_NAME 档位。发送请求前请检查你的可用档位。

快速示例

curl https://api.seedrouter.ai/v1beta/models/gemini-4-neon:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Audit this payment retry queue for race conditions and propose lock acquisition steps."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"high"},"maxOutputTokens":65536}}'

模型应放在 URL 中。contents 为必填项。回答包含原生 candidates、finishReason 和 usageMetadata;请在对话历史中保留完整内容部分,包括 thoughtSignature。困难提示词的处理可能持续数分钟。Google 建议将客户端超时设为 20 分钟。使用流式模式可在输出可用时陆续接收。

端点

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

OpenAPI 规范包含所有嵌套请求和响应 schema。省略可选字段时使用 API 默认值。公开原生 API 保留提交的请求体,交由 Gemini 校验。Playground 还会在提交前检查文档约束,并执行其安全设置。

请求参数

URL 将模型固定为 gemini-4-neon。请求契约包含 11 个顶层字段。除非标为必填,否则字段均可选;省略不同于 JSON null。官方 schema 允许时,会保留可为 null 的任意 JSON。

字段类型必填默认值与约束
contentsobject[]是非空对话;每项 content 都有非空 parts
systemInstructionobject否仅文本内容部分;不会自动插入用户身份
generationConfigobject否生成参数见下表
toolsobject[]否函数声明和内置工具配置
toolConfigobject否函数选择与检索配置
safetySettingsobject[]否每个类别一个设置;类别不可重复
serviceTierstring否unspecified、standard、flex、priority;普通处理为 standard
continuationTokenstring否随 finishReason: CONTINUATION 或 MAX_TOKENS 返回的 token;携带它重发同一请求可续写长回答
labelsobject否字符串值;键和值均为小写,每项最多 63 个 Unicode 码点
modelstring否可选资源名称;实际模型由 URL 决定
storeboolean否通用请求存储偏好;尚未验证对本模型的具体影响

Gemini 4 Neon 不支持显式上下文缓存(cachedContent 和 cachedContents 资源)。至少 4,096 token 的提示词默认启用隐式缓存。

生成参数

generationConfig 中的字段类型默认值与约束
maxOutputTokensinteger默认 65,536,包含思考。通过续写最多可达 1,048,576 减去输入量。每次流式或非流式响应最多支持 65,536 token;更长输出请使用续写
thinkingConfigobjectthinkingLevel:low、medium、high、xhigh(默认 high);接受大写拼写。includeThoughts:boolean,默认 false。请使用 thinkingLevel;已弃用的 thinkingBudget 单独提供时会附带警告并映射为某个级别,且不可与 thinkingLevel 同时使用
stopSequencesstring[]最多五个序列
responseMimeTypestring默认 text/plain;旧版 JSON schema 输出要求 application/json
responseSchemaobject官方 schema 方言;与 responseJsonSchema 互斥
responseJsonSchemaJSONJSON Schema;与 responseSchema 互斥
responseFormatobject文本格式配置;text.mimeType 与可选 text.schema。Schema 要求 JSON MIME 类型
responseModalitiesstring[]仅文本:TEXT;为空表示文本
mediaResolutionenumMEDIA_RESOLUTION_UNSPECIFIED、LOW、MEDIUM、HIGH,使用 MEDIA_RESOLUTION_ 前缀
seedinteger有符号 32 位值;尚未验证本模型的确定性行为
presencePenaltynumber通用字段;尚未验证对本模型的具体影响或范围
frequencyPenaltynumber通用字段;尚未验证对本模型的具体影响或范围
responseLogprobsboolean通用字段;尚未验证在本模型中的可用性
logprobsinteger0–20;要求 responseLogprobs: true;尚未验证模型支持情况
enableEnhancedCivicAnswersboolean通用字段;尚未验证模型支持情况
enableAffectiveDialogboolean通用字段;尚未验证模型支持情况
audioTranscriptionConfigobject通用字段;尚未验证本模型的具体选项
translationConfigobject通用字段;尚未验证本模型的具体选项

OpenAPI 文档列出了每条消息的嵌套类型、枚举、必填属性和文档规定的边界,包括来自 v1beta 发现规范的 audioMetadata、documentMetadata、spreadsheetMetadata 和 videoMetadata.contentLayers。Schema 描述官方参数,并非 SeedRouter 请求白名单。调用方提供的字段和值会被保留。字段被 schema 接受,不代表每个账户都支持。minimal 不在列出的思考级别中。Google 表示 temperature、topP、topK 和 candidateCount 已弃用,应移除;范围内的自定义采样值会被忽略,超出范围的值会返回 400。如果通过原生 JSON 提交,它们仍会原样传递,交由 Gemini API 处理。

长文本分段生成

Gemini 4 Neon 每次流式响应最多返回 65,536 token,非流式响应同样最多返回 65,536 token。需要更长输出时,将 maxOutputTokens 设为大于 65,536,并自行续写回答:

  1. 发送请求。如果响应以 finishReason: "CONTINUATION" 结束,读取 candidates[0].continuationToken。
  2. 将该值放入顶层 continuationToken 字段,重发同一条请求。不要将部分输出追加到 contents;token 携带模型状态,包括其思考。
  3. 重复操作,直至 finishReason 为 STOP 或 MAX_TOKENS。如果某次调用触及 MAX_TOKENS 并返回了 continuationToken,只有提高 maxOutputTokens 才能继续生成;沿用同一上限会返回 400 INVALID_ARGUMENT。
{
  "contents": [{"role": "user", "parts": [{"text": "Generate a complete multi-module migration specification and verification checklist for this payment service."}]}],
  "generationConfig": {"thinkingConfig": {"thinkingLevel": "high"}, "maxOutputTokens": 262144},
  "continuationToken": "TOKEN_FROM_THE_PREVIOUS_RESPONSE"
}

一次响应若全部用于思考,可能返回空文本并带有 CONTINUATION;这是正常进展。每轮请求都会将提示词和截至当前已生成的全部内容送回模型,因此后续每轮请求都会重新计算输入 token(重复前缀符合隐式缓存条件)。SeedRouter 将每轮请求分别作为独立请求计费。Interactions API 的服务器端 background 模式不属于此端点。

结构化输出

{
  "contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
  "generationConfig": {
    "thinkingConfig": {"thinkingLevel": "low"},
    "maxOutputTokens": 65536,
    "responseMimeType": "application/json",
    "responseJsonSchema": {
      "type": "object",
      "properties": {"ok": {"type": "boolean"}},
      "required": ["ok"]
    }
  }
}

旧版 responseSchema 和 responseJsonSchema 字段不能同时使用。两者都要求 responseMimeType: "application/json"。新版 responseFormat.text schema 同样必须指定 JSON。在该消息中使用 REST 枚举拼写(APPLICATION_JSON 和 TEXT_PLAIN)。请求原样传递;媒体 MIME 类型和任意函数 JSON 不会被改写。

函数与内置工具

使用 tools[].functionDeclarations,提供名称以及 parameters 或 parametersJsonSchema 其中之一,不能同时提供。函数选择位于 toolConfig.functionCallingConfig;allowedFunctionNames 要求 ANY 或 VALIDATED,且名称必须已声明。不要在未声明工具的情况下通过系统指令要求模型输出纯文本 JSON 工具调用,否则可能返回 MALFORMED_FUNCTION_CALL。

由你的应用执行返回的函数,并在下一轮对话中提供结果。保留每个原始 thoughtSignature、函数调用和函数响应。不要在并行的 functionCall 部分之间复制思考签名,序列化不透明函数参数时也不要对数字标识符进行舍入。

Google 为 Gemini 4 Neon 列出了 Search、Maps、代码执行、URL 上下文、File Search 和 Computer Use。File Search 资源需要处理该请求的凭据具备访问权限。通用 schema 中包含原生 MCP 配置,但尚未确定此模型是否可用。将工具与媒体结合前,请检查各工具的官方限制。使用 grounding 时,Google 将内部工具指令和函数声明计为输入 token。Playground 不会执行你的自定义函数。

多模态输入与安全

每个 contents[].parts[] 项恰好包含一种负载:文本、内联媒体、文件引用、函数调用/响应,或执行部分。还可携带签名或媒体元数据(videoMetadata、audioMetadata、documentMetadata、spreadsheetMetadata、mediaResolution、mediaProcessing)。输入支持文本、图片、音频、视频和 PDF;输出仅为文本。模型不生成图片或音频,也没有 Live API。

对于内联字节,使用 inlineData.mimeType 和 base64 data。对于文件引用,使用 fileData.mimeType 和 fileUri。URL 语法有效不代表模型能获取其内容。视频元数据可指定 startOffset、endOffset、不大于 24 的正数 fps 以及 contentLayers。在视频的 fileData 或 inlineData 旁设置 mediaProcessing: "AGENTIC",可按内容部分选择智能体式视频理解;默认采用静态处理。

安全设置使用官方原生格式,经 API 原样传递。在 Playground 中,全部四个类别都必须设为 BLOCK_MEDIUM_AND_ABOVE 或更严格;更低阈值只能通过 API 使用。

JSON 响应与流式模式

generateContent 返回原生 JSON。streamGenerateContent?alt=sse 在 SSE data: 事件中输出原生 JSON。重要字段包括 candidates[].content.parts、finishReason、continuationToken、safetyRatings、groundingMetadata、promptFeedback、modelVersion、responseId 和 usageMetadata。

在对话历史中保留完整原生内容。思考摘要不同于思考签名。连接断开不能证明生成已失败或完成;发送另一条请求前,请检查部分结果和账户记录。流式用量为累计值,请使用最新计数器,不要将各个片段相加。

用量与价格

promptTokenCount 包含缓存输入。cachedContentTokenCount 按缓存输入费率收费,不会再按非缓存输入重复计费。计费输出包含 candidatesTokenCount 加 thoughtsTokenCount。Gemini 4 Neon 默认采用 high 思考级别。与其他模型比较用量时,请明确设置级别。

本模型没有按上下文长度划分的价格阶梯。SeedRouter 当前价格使用 Standard token 费率;此接入尚未配置 Flex 折扣和 Priority 附加费。这些处理档位是否受支持,仍需验证。Google Search grounding 可能在 token 用量之外产生按查询计费的费用;启用前请检查工具价格。失败的请求不收费。参见实时价格表。

账户分组

Default 档位使用不带后缀的 gemini-4-neon 模型 ID。其他档位在 URL 中使用 gemini-4-neon:GROUP_NAME。Playground 会选择可用档位;API 也接受显式请求头:

X-SeedRouter-Group: GROUP_NAME

所选分组决定价格和可用容量;明确选择后,不会静默切换到其他分组。省略请求头或使用 auto,可保留 API key 的默认行为。

无需生成回答,即可检查 API key 可用的分组:

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

验证状态

官方文档与 REST 发现修订版 20261119 已于 2026 年 11 月 20 日核对。当天,只读模型发现(GET /v1/models)、分组发现(GET /api/seedrouter/llm/groups?model=gemini-4-neon)和公开价格(GET /v1/pricing)均确认存在 Default 档位 gemini-4-neon 和显式档位 gemini-4-neon:googlellm-vertext。通过 api.seedrouter.ai 进行的三次单次尝试付费冒烟调用也均以 HTTP 200 完成:在 Default 档位使用 low 思考级别的 JSON 生成(54 提示词 token、28 输出 token、39 思考 token)、在 Default 档位使用 xhigh 思考级别的 SSE 流式响应(50 提示词 token、13 输出 token、207 思考 token),以及在 gemini-4-neon:googlellm-vertext 档位使用 low 思考级别的已声明 functionCall(95 提示词 token、22 输出 token、49 思考 token,并返回了 thoughtSignature)。原生请求体透传和响应字段白名单需要部署更新后的后端构建。媒体理解、grounding、Computer Use、续写/长文本分段生成、其他通用字段和处理档位仍未验证,且这些检查不能确立相对质量或延迟结论。

参考资料