Gemini 4 Carbon API

Gemini 4 Carbon 支持 Gemini 原生请求格式。请先在本站模型目录确认模型已开放及当前用户售价；未开放时返回模型不可用，不创建收费调用。

接口与鉴权

格式	地址	鉴权
原生 JSON	`/api/v1beta/models/gemini-4-carbon:generateContent`	`x-goog-api-key: 本站APIKey` 或 Bearer
原生 SSE	`/api/v1beta/models/gemini-4-carbon:streamGenerateContent?alt=sse`	同上


curl 'https://YOUR_SITE/api/v1beta/models/gemini-4-carbon:generateContent' \

  -H 'Authorization: Bearer YOUR_API_KEY' \

  -H 'Content-Type: application/json' \

  --data '{"contents":[{"role":"user","parts":[{"text":"你好"}]}],"generationConfig":{"maxOutputTokens":1024,"thinkingConfig":{"thinkingLevel":"medium"}}}'

Google GenAI SDK 使用本站域名加 /api 为 base URL，API 版本为 v1beta，模型为 gemini-4-carbon。本站同时提供 /api/v1/chat/completions 格式转换，用于角色扮演等普通聊天客户端；不提供此模型的 Responses 或 Messages 接口。

参数与限制

contents 为非空对话数组，支持文本和公网 HTTP(S) 媒体地址；不接受内嵌媒体。
systemInstruction、tools、toolConfig、safetySettings 和嵌套 JSON Schema 按原生格式提交。
thinkingConfig.thinkingLevel 支持 low、medium、high，默认由模型处理。
generationConfig.maxOutputTokens 包含思考用量；普通请求最多 32768，流式最多 65536。
本站单次请求最长四分钟，请求体最多 32 MiB。长任务建议流式请求。
完整保留返回的 thoughtSignature、函数调用与结果，在下一轮原生对话中回传。
显式上下文缓存不支持；可用的隐式缓存按返回用量计费。

流式、续写与计费

SSE 在完整结果及计费核对后发送，无逐 Token 实时延迟保证；原生流在 EOF 结束，没有 [DONE]。

每次请求独立执行并计费。本站不自动重试、不自动续写、不自动执行工具，也不提供幂等重放。遇到 CONTINUATION 时由客户端使用返回的 continuationToken 发起下一次请求；每次仍须满足本站输出上限。关闭 SDK 的自动重试和自动续写以避免重复消费。

输入、缓存输入与输出按本站独立用户售价结算；思考 Token 计入输出，SSE 累计用量只采用最终快照。未知消费会保留冻结等待核对，请勿自动重复提交。仅支持标准 Token 计费调用；不承诺单独收费的搜索、地图等扩展工具可用。

GET /api/v1/models 与 GET /api/v1/models/gemini-4-carbon 返回已开放模型、接口能力及用户售价。HTML 文档位于 /api/gemini-4-carbon，Markdown 位于 /api/gemini-4-carbon/markdown。

角色扮演聊天补全


curl 'https://YOUR_SITE/api/v1/chat/completions' \

  -H 'Authorization: Bearer YOUR_API_KEY' \

  -H 'Content-Type: application/json' \

  --data '{"model":"gemini-4-carbon","messages":[{"role":"system","content":"你是一位温柔的书店主人，保持人物设定。"},{"role":"assistant","content":"欢迎来到书店。"},{"role":"user","content":"推荐一本书吧。"}],"max_tokens":2048,"stream":false}'

兼容入口支持 system、user、assistant 历史、文本和公网图片、max_tokens / max_completion_tokens、reasoning_effort（low / medium / high），以及 JSON 或 SSE 返回。SSE 采用聊天补全的 [DONE] 结束标记；仅在完整结果核对后发送。

角色扮演预设中的采样参数不保证生效：本模型忽略温度和 Top P；兼容层不下发频率与存在惩罚。不支持助手末尾预填续写。函数工具和签名状态请走 Gemini 原生接口。