Developer Documentation

1. Quick Start

Three steps to your first API call.

curl https://aihubapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://aihubapi.ai/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: 'https://aihubapi.ai/v1',
});

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Hello!' }],
});

console.log(response.choices[0].message.content);

import "github.com/sashabaranov/go-openai"

config := openai.DefaultConfig("sk-your-api-key")
config.BaseURL = "https://aihubapi.ai/v1"
client := openai.NewClientWithConfig(config)

resp, _ := client.CreateChatCompletion(ctx, openai.ChatCompletionRequest{
    Model:    "gpt-4o",
    Messages: []openai.ChatCompletionMessage{
        {Role: "user", Content: "Hello!"},
    },
})

2. Authentication

Environment variables (recommended)

Most OpenAI-compatible SDKs read these automatically:

export OPENAI_API_KEY=sk-your-api-key
export OPENAI_BASE_URL=https://aihubapi.ai/v1

3. API Reference

POST /v1/chat/completions

Create a chat completion. Supports all OpenAI-compatible parameters.

Response

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1712345678,
  "model": "gpt-4o",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Hello! How can I help you today?"
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 9,
    "total_tokens": 21
  }
}

Streaming

Set "stream": true to receive Server-Sent Events. Each event is a JSON chunk:

data: {"id":"chatcmpl-abc","choices":[{"delta":{"content":"Hello"}}]}
data: {"id":"chatcmpl-abc","choices":[{"delta":{"content":"!"}}]}
data: [DONE]

GET /v1/models

List all available models. Returns an array of model objects with id, object, created, and owned_by fields.

curl https://aihubapi.ai/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

Error Codes

Error responses follow this format:

{
  "error": {
    "code": "model_not_found",
    "message": "No available channel for model X under group default",
    "type": "new_api_error"
  }
}

4. Models

AIHubAPI provides access to 350+ models from all major providers via a single API. Here are the most popular ones:

OpenAI

Anthropic

Google

DeepSeek

Meta, Mistral, Qwen, xAI & more

5. SDKs & Code Examples

AIHubAPI works with any OpenAI-compatible SDK. No special client needed.

Python — Streaming

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://aihubapi.ai/v1"
)

stream = client.chat.completions.create(
    model="claude-sonnet-4.6",
    messages=[{"role": "user", "content": "Explain quantum computing"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Node.js — Streaming

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: 'https://aihubapi.ai/v1',
});

const stream = await client.chat.completions.create({
  model: 'deepseek-chat',
  messages: [{ role: 'user', content: 'Hello!' }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || '');
}

Go

package main

import (
    "context"
    "fmt"
    openai "github.com/sashabaranov/go-openai"
)

func main() {
    config := openai.DefaultConfig("sk-your-api-key")
    config.BaseURL = "https://aihubapi.ai/v1"
    client := openai.NewClientWithConfig(config)

    resp, _ := client.CreateChatCompletion(
        context.Background(),
        openai.ChatCompletionRequest{
            Model:    "gpt-4o",
            Messages: []openai.ChatCompletionMessage{
                {Role: "user", Content: "Hello!"},
            },
        },
    )
    fmt.Println(resp.Choices[0].Message.Content)
}

6. Integrations

Any tool that supports a custom OpenAI base URL works with AIHubAPI.

Cursor

Settings → Models → OpenAI API Key: sk-your-api-key
Override OpenAI Base URL: https://aihubapi.ai/v1

VS Code — Continue

{
  "models": [{
    "provider": "openai",
    "model": "deepseek-chat",
    "apiBase": "https://aihubapi.ai/v1",
    "apiKey": "sk-your-api-key"
  }]
}

Aider

aider --openai-api-base https://aihubapi.ai/v1 --openai-api-key sk-your-api-key

LobeChat

Settings → Language Model → OpenAI → API Proxy URL: https://aihubapi.ai/v1

Cherry Studio

Settings → Model Services → Add custom provider → API URL: https://aihubapi.ai

7. Features

• 500+ Models, One Key — Access GPT, Claude, Gemini, DeepSeek, Llama, Mistral, Qwen, Grok, and many more through a single API key.
• OpenAI SDK Compatible — Drop-in replacement. Change only the base URL; your existing code, prompts, and tool calls work as-is.
• Smart Routing & Failover — Automatic failover across upstream providers. If one goes down, requests route to the next available channel.
• Model Aliases — Use short names (gpt-4o, claude-sonnet-4-6) or full OpenRouter slugs (openai/gpt-4o). Both are supported.
• Streaming — Full SSE streaming support for all chat models.
• Pay Per Token — No monthly fees, no minimums. Prepay credits and use across all models. Credits never expire.
• Privacy First — No prompt logging by default. All traffic encrypted via TLS 1.2+.

8. FAQ & Troubleshooting