# 文档中心

从第一次调用到生产环境接入，了解 G 网的模型接口、工具配置和计费方式。

G 网为对话、图片和视频模型提供统一接入。你可以使用熟悉的 OpenAI 或 Anthropic 客户端，通过一个 API Key 调用已授权的模型，并在控制台查看用量和费用。

## 开始接入 [#开始接入]


  - [快速开始](/docs/quickstart)：创建 API Key，使用 cURL、Python 或 Node.js 发起第一次调用。
  - [API Key 与鉴权](/docs/authentication)：区分模型 API 与控制台会话，安全保存和使用密钥。
  - [模型与能力](/docs/models)：查询模型 ID、类型和价格，选择符合任务要求的模型。
  - [工具接入](/docs/agent-tools)：配置 Claude Code、Codex CLI 和其他兼容客户端。


## 接口一览 [#接口一览]

| 任务 | 接口 | 文档 |
| --- | --- | --- |
| 多轮对话 | `POST /v1/chat/completions` | [OpenAI 兼容 API](/docs/openai-api) |
| Responses 格式请求 | `POST /v1/responses` | [Responses API](/docs/responses) |
| Anthropic 格式对话 | `POST /v1/messages` | [Anthropic 兼容 API](/docs/anthropic-api) |
| 向量嵌入 | `POST /v1/embeddings` | [文本嵌入](/docs/embeddings) |
| 图片生成 | `POST /v1/images/generations` | [图片生成](/docs/image-generation) |
| 视频生成 | `POST /v1/videos` | [视频生成](/docs/video-generation) |
| 模型目录 | `GET /v1/models` | [模型与能力](/docs/models) |


**提示**

协议兼容不代表所有模型都具备相同能力。流式输出、工具调用、结构化输出和多模态输入，需同时得到所选模型及其服务通道支持。模型名称以 [模型库](/models) 的模型 ID 为准。


## 进阶能力 [#进阶能力]

- [流式输出](/docs/streaming)：处理 SSE 增量事件、结束信号和中途错误。
- [工具调用](/docs/tool-calls)：返回工具结果，完成多轮工具交互。
- [结构化输出](/docs/structured-output)：约束输出格式并在应用层校验结果。
- [推理模型](/docs/reasoning)：区分思考过程和最终回答。

## 工具与 SDK [#工具与-sdk]


  - [Claude Code](/docs/claude-code)：配置 Anthropic 网关地址、密钥和模型。
  - [Codex CLI](/docs/codex)：使用自定义 Provider 和 Responses 协议接入。


SDK 的模型请求地址为 `https://api.gfw.net/v1`；使用 Anthropic SDK 时，`base_url` 填写 `https://api.gfw.net`。详见对应接口文档中的示例。

## 计费与排障 [#计费与排障]

在 [计费与充值](/docs/billing) 了解计价单位、模型价格和订单状态；通过 [用量与调用日志](/docs/usage-logs) 定位请求和核对费用。

遇到问题时，先查看 [错误码与重试](/docs/errors)。报障信息应包含请求时间、模型 ID、HTTP 状态码和请求标识；不要发送 API Key 或完整的敏感请求内容。
