> ## 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 Complete Integration Guide

> One-stop guide to understand AIHubMix's universal model calling methods

AIHubMix uses OpenAI model calling interface as the standard, aggregating multiple models including OpenAI, Google Gemini, Anthropic Claude and other series models. Calling any model uses the same method, just need to modify the corresponding `model ID`.

<Tip>
  Key points: Only need to add the forwarding `base_url` and AiHubMix platform [API key](https://aihubmix.com/token) inside the client. Model IDs can be obtained by clicking the "Copy Button" on [model marketplace cards](https://aihubmix.com/models).
</Tip>

## Basic Integration: Using OpenAI Official Library

### Python Example

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

client = OpenAI(
    api_key="sk-***", # Replace with your AiHubMix generated API key
    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",  # Replace with any supported model ID
)

print(chat_completion)
```

<Info>
  OpenAI official current service status [check](https://status.openai.com/)
</Info>

## Universal Model Forwarding API

Endpoint: `POST` /v1/chat/completions

**Body Request Parameters:**

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

### Request Parameters

| Name          | Location | Type   | Required | Description               |
| ------------- | -------- | ------ | -------- | ------------------------- |
| Authorization | header   | string | No       | Bearer AIHUBMIX\_API\_KEY |
| Content-Type  | header   | string | No       | none                      |
| body          | body     | object | No       | none                      |

**Response Example:**

```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
  }
}
```

### Response Results

| Status Code | Status Code Meaning | Description | Data Model |
| ----------- | ------------------- | ----------- | ---------- |
| 200         | OK                  | none        | Inline     |

***

Last updated: 2026-06-01