> ## 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 一站式集成

> 了解 AIhubMix 的通用模型调用方式

AIHubMix 以 OpenAI 模型调用接口为标准，聚合了 OpenAI、谷歌 Gemini、Anthropic Claude 等多家主流大模型。通过统一的 API 接口，您可以无缝调用多个不同厂商的700➕模型。只需修改对应的 模型 ID，即可在同一套代码中切换使用 OpenAI、Gemini、Claude 等任意模型，无需学习和适配不同的调用协议。

<Tip>
  核心要点：只需要在 client 内部加入转发的 `base_url` 和 AIHubMix 平台的[密钥](https://aihubmix.com/token)。 模型 ID 可以在[模型广场的卡片上](https://aihubmix.com/models)点击「复制按钮」来获取。
</Tip>

## 基础集成：使用 OpenAI 官方库

### Python 示例

```py Python theme={null}
from openai import OpenAI

client = OpenAI(
    api_key="sk-***", # 换成你在 AiHubMix 生成的密钥
    base_url="https://aihubmix.com/v1"
)

chat_completion = client.chat.completions.create(
    messages=[
        {
            "role": "user",
            "content": "Say this is a test",
        }
    ],
    model="gpt-4o-mini",  # 替换为任意支持的模型 ID
)

print(chat_completion)
```

<Info>
  OpenAI 官方当前服务状态 [查询](https://status.openai.com/)
</Info>

## 通用模型转发 API

端点（Endpoint）： `POST` /v1/chat/completions

**Body 请求参数：**

```json theme={null}
{
  "model": "gpt-4o-mini",
  "messages": [
    {
      "role": "user",
      "content": "What is the meaning of life?"
    }
  ]
}
```

### 请求参数

| 名称            | 位置     | 类型     | 必选 | 说明                        |
| ------------- | ------ | ------ | -- | ------------------------- |
| Authorization | header | string | 否  | Bearer AIHUBMIX\_API\_KEY |
| Content-Type  | header | string | 否  | none                      |
| body          | body   | object | 否  | none                      |

**返回示例：**

```json theme={null}
200 Response
```

```json theme={null}
{
  "id": "chatcmpl-AzJqsyf2h02BKjrqHMA1HVUQpiDfL",
  "model": "gpt-4o-mini",
  "object": "chat.completion",
  "created": 1739177682,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "The meaning of life is a philosophical question that has been debated for centuries. Different people and cultures may have different beliefs about the purpose and significance of life. Some believe that the meaning of life is to seek happiness and fulfillment, while others believe in spiritual or religious meanings such as serving a higher power or fulfilling a destiny. Ultimately, the meaning of life may be a deeply personal and individual question that each person must answer for themselves."
      },
      "finish_reason": "stop"
    }
  ],
  "system_fingerprint": "fp_0165350fbb",
  "usage": {
    "prompt_tokens": 14,
    "completion_tokens": 86,
    "total_tokens": 100
  }
}
```

### 返回结果

| 状态码 | 状态码含义 | 说明   | 数据模型   |
| --- | ----- | ---- | ------ |
| 200 | OK    | none | Inline |

***

更新时间：2026-06-01