> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# `<工具名>` 配置 AIHubMix 指南：Claude Code/Codex/Gemini 一键接入

> <130–160 字：含主关键词 + 用户搜得到的术语 + 示例语言列表（如 JavaScript, Python, cURL）。回答『这页帮用户做什么』，不是『这页是什么』。

> **TL;DR：** `<一句话答案，30 字内>`。`<工具名>` 通过在 `base_url` 填 `https://aihubmix.com/v1` + `sk-` 开头的 API key 完成接入，全程不超过 2 分钟。

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/aihubmix/images/%3Cslug%3E/hero.png" alt="<描述性 alt：画面里有什么，禁止写 &#x22;screenshot&#x22; / &#x22;Image&#x22; / &#x22;截图&#x22;>" />
</Frame>

## `<工具名>` 是什么？

`<一段话：工具定位 + 适用人群 + 主关键词。把用户最关心的词自然写进去。>`

## 怎么接入 AIHubMix？

`<answer-first：第一段就给最重要的命令/配置。具体数字优先于描述：>`

* API base URL：`https://aihubmix.com/v1`
* 免费档限制：**每个 API key 每分钟 60 请求**，超出返回 `429`
* 支持模型：`claude-opus-4-7`、`gpt-5`、`gemini-2.5-pro` 等

```bash theme={null}
curl -H "Authorization: Bearer $AIHUBMIX_KEY" \
  -H "Content-Type: application/json" \
  https://aihubmix.com/v1/chat/completions \
  -d '{"model":"claude-opus-4-7","messages":[{"role":"user","content":"hi"}]}'
```

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/aihubmix/images/%3Cslug%3E/first-call.png" alt="<工具名> 完成接入后的首次响应：左侧显示 200 状态码 + 流式 token 输出" />
</Frame>

## 如何排查 401 / 429 错误？

| 错误码 | 含义            | 排查                                            |
| --- | ------------- | --------------------------------------------- |
| 401 | API key 无效或未传 | 检查 `Authorization: Bearer` 前缀；key 须以 `sk-` 开头 |
| 429 | 超额            | 等 60 秒或换 key；详见 [限速说明](/cn/FAQs/HTTP-Codes)   |

## `<工具名>` vs `<竞品>`：怎么选？

| 对比维度          | `<工具名>` | `<竞品>` |
| ------------- | ------- | ------ |
| 上手成本          | 低（GUI）  | 中（CLI） |
| 多 Provider 切换 | 支持      | 不支持    |
| 价格            | 免费      | \$X/月  |

**结论：** `<一句话推荐路径>`。

## 常见问题 FAQ

<AccordionGroup>
  <Accordion title="为什么我收到 401 Unauthorized？">
    检查三处：① `Authorization` 头是否带 `Bearer ` 前缀；② key 是否完整复制（`sk-` 开头）；③ 是否传到了正确的域名（`https://aihubmix.com/v1`，不是 `api.aihubmix.com`）。
  </Accordion>

  <Accordion title="速率限制是多少？超额会怎样？">
    免费档每分钟 60 请求，付费档每分钟 600 请求。超额返回 HTTP `429`，建议客户端按 `Retry-After` 头退避重试。
  </Accordion>

  <Accordion title="支持哪些模型？">
    主流模型全覆盖：Claude（opus/sonnet/haiku 全系）、GPT（gpt-5/gpt-4.5）、Gemini（2.5-pro/flash）、Deepseek、Qwen、Kimi 等。完整列表参考 [模型清单](/cn/api/models)。
  </Accordion>
</AccordionGroup>

***

更新时间：2026-05-29