# 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` | 同上 |

```bash
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`。


## 角色扮演聊天补全

```bash
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 原生接口。