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 four protocol families — OpenAI-compatible, Anthropic, Grok / xAI, and Gemini. 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-5.4-mini",
    "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-5.4-mini",
    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-5.4-mini',
    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-sonnet-4.6",
    "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-sonnet-4.6",
    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-sonnet-4.6',
    max_tokens: 1024,
    messages: [
      { role: 'user', content: 'What is the meaning of life?' }
    ]
  })
 
  console.log(message.content[0].text)
}
 
main()

Grok / xAI

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

cURL

Terminal


curl https://api.hao.ai/grok/v1/chat/completions \
  -H "Authorization: Bearer <your HAOAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok/grok-4.5",
    "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/grok/v1",
    api_key="<your HAOAI_API_KEY>",
)
 
response = client.chat.completions.create(
    model="grok/grok-4.5",
    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/grok/v1',
  apiKey: '<your HAOAI_API_KEY>'
})
 
async function main() {
  const response = await client.chat.completions.create({
    model: 'grok/grok-4.5',
    messages: [
      { role: 'user', content: 'Introduce HaoAI Gateway in one sentence.' }
    ]
  })
 
  console.log(response.choices[0].message.content)
}
 
main()

Gemini SDK

Gemini Native Protocol — Use the Google GenAI SDK with full Gemini model support.

cURL

Terminal


# HaoAI API endpoint. Get your API Key at https://hao.ai/console/api-keys
curl "https://api.hao.ai/gemini/v1beta/models/google/gemini-3.1-flash-lite-preview:generateContent" \
  -H "x-goog-api-key: <your HAOAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "What is the meaning of life?"}]}
    ]
  }'

Python

quickstart_gemini.py


from google import genai
 
client = genai.Client(
    # Get your key at https://hao.ai/console/api-keys
    api_key="<your HAOAI_API_KEY>",
    # HaoAI API endpoint
    http_options={"api_version": "v1beta", "base_url": "https://api.hao.ai/gemini",}
)
 
response = client.models.generate_content(
    model="google/gemini-3.1-flash-lite-preview",
    contents="What is the meaning of life?"
)
 
print(response.text)

TypeScript

quickstart_gemini.ts


import { GoogleGenAI } from '@google/genai'
 
const ai = new GoogleGenAI({
  // Get your key at https://hao.ai/console/api-keys
  apiKey: '<your HAOAI_API_KEY>',
  // HaoAI API endpoint
  httpOptions: {
    apiVersion: 'v1beta',
    baseUrl: 'https://api.hao.ai/gemini',
  }
})
 
async function main() {
  const response = await ai.models.generateContent({
    model: 'google/gemini-3.1-flash-lite-preview',
    contents: 'What is the meaning of life?'
  })
 
  console.log(response.text)
}
 
main()

Next Steps

🔑 Authentication 📊 Model Catalog 🔧 API Reference 🛠️ Integrations