Quick Start

This guide helps you integrate with the HaoAI Gateway and start calling leading global models in just 3 minutes.

Prerequisites

Go to the HaoAI Console
Open the API Keys page
Click Create API Key
Have a development environment ready (Python 3.8+ / Node.js 18+)

HaoAI offers three protocol families — OpenAI-compatible, Anthropic, and SpaceXAI. Grok uses its own route with an xAI OpenAI-compatible text interface.

Choose Your Protocol

OpenAI SDK (Recommended)

OpenAI Compatible Protocol — The most universal integration method.

cURL

Terminal


# HaoAI API endpoint. Get your API Key at https://hao.ai/console/api-keys
curl https://api.hao.ai/v1/chat/completions \
  -H "Authorization: Bearer <your HAOAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-astra",
    "messages": [
      {"role": "user", "content": "What is the meaning of life?"}
    ]
  }'

Python

quickstart.py


from openai import OpenAI
 
client = OpenAI(
    # HaoAI API endpoint
    base_url="https://api.hao.ai/v1",
    # Get your key at https://hao.ai/console/api-keys
    api_key="<your HAOAI_API_KEY>"
)
 
response = client.chat.completions.create(
    model="openai/gpt-6-astra",
    messages=[
        {"role": "user", "content": "What is the meaning of life?"}
    ]
)
 
print(response.choices[0].message.content)

TypeScript

quickstart.ts


import OpenAI from 'openai'
 
const client = new OpenAI({
  // HaoAI API endpoint
  baseURL: 'https://api.hao.ai/v1',
  // Get your key at https://hao.ai/console/api-keys
  apiKey: '<your HAOAI_API_KEY>'
})
 
async function main() {
  const response = await client.chat.completions.create({
    model: 'openai/gpt-6-astra',
    messages: [
      { role: 'user', content: 'What is the meaning of life?' }
    ]
  })
 
  console.log(response.choices[0].message.content)
}
 
main()

Anthropic SDK

Anthropic Native Protocol — Use the Anthropic SDK directly with full Claude feature support.

cURL

Terminal


# HaoAI API endpoint. Get your API Key at https://hao.ai/console/api-keys
curl https://api.hao.ai/anthropic/v1/messages \
  -H "x-api-key: <your HAOAI_API_KEY>" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-fable-5-1",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "What is the meaning of life?"}
    ]
  }'

Python

quickstart_anthropic.py


import anthropic
 
client = anthropic.Anthropic(
    # HaoAI API endpoint
    base_url="https://api.hao.ai/anthropic",
    # Get your key at https://hao.ai/console/api-keys
    api_key="<your HAOAI_API_KEY>"
)
 
message = client.messages.create(
    model="anthropic/claude-fable-5-1",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "What is the meaning of life?"}
    ]
)
 
print(message.content[0].text)

TypeScript

quickstart_anthropic.ts


import Anthropic from '@anthropic-ai/sdk'
 
const client = new Anthropic({
  // HaoAI API endpoint
  baseURL: 'https://api.hao.ai/anthropic',
  // Get your key at https://hao.ai/console/api-keys
  apiKey: '<your HAOAI_API_KEY>'
})
 
async function main() {
  const message = await client.messages.create({
    model: 'anthropic/claude-fable-5-1',
    max_tokens: 1024,
    messages: [
      { role: 'user', content: 'What is the meaning of life?' }
    ]
  })
 
  console.log(message.content[0].text)
}
 
main()

SpaceXAI

SpaceXAI Protocol — Use the SpaceXAI route. Its text JSON/SSE shape is compatible with xAI’s OpenAI-compatible interface.

cURL

Terminal


curl https://api.hao.ai/x-ai/v1/chat/completions \
  -H "Authorization: Bearer <your HAOAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "x-ai/grok-4.6",
    "messages": [
      {"role": "user", "content": "Introduce HaoAI Gateway in one sentence."}
    ]
  }'

Python

quickstart_grok.py


from openai import OpenAI
 
client = OpenAI(
    base_url="https://api.hao.ai/x-ai/v1",
    api_key="<your HAOAI_API_KEY>",
)
 
response = client.chat.completions.create(
    model="x-ai/grok-4.6",
    messages=[
        {"role": "user", "content": "Introduce HaoAI Gateway in one sentence."}
    ],
)
 
print(response.choices[0].message.content)

TypeScript

quickstart_grok.ts


import OpenAI from 'openai'
 
const client = new OpenAI({
  baseURL: 'https://api.hao.ai/x-ai/v1',
  apiKey: '<your HAOAI_API_KEY>'
})
 
async function main() {
  const response = await client.chat.completions.create({
    model: 'x-ai/grok-4.6',
    messages: [
      { role: 'user', content: 'Introduce HaoAI Gateway in one sentence.' }
    ]
  })
 
  console.log(response.choices[0].message.content)
}
 
main()

Next Steps

🔑 Authentication 📊 Model Catalog 🔧 API Reference 🛠️ Integrations