开发文档快速开始
快速开始
本指南帮助你在 3 分钟内接入 HaoAI Gateway，开始调用 100+ 大模型。
前置要求
- 注册 HaoAI 控制台 获取 API Key
- 准备开发环境（Python 3.8+ / Node.js 18+）
HaoAI 兼容 OpenAI / Anthropic / Gemini 三大协议，你可以使用任意官方 SDK 接入。
选择接入方式
OpenAI SDK（推荐）
OpenAI 兼容协议 — 最通用的接入方式。
cURL
Terminal
curl https://api.hao.ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_HAOAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{ "role": "user", "content": "用一句话介绍 HaoAI Gateway" }
]
}'Python
quickstart.py
from openai import OpenAI
client = OpenAI(
base_url="https://api.hao.ai/v1",
api_key="YOUR_HAOAI_API_KEY",
)
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[
{"role": "user", "content": "用一句话介绍 HaoAI Gateway"}
],
)
print(response.choices[0].message.content)TypeScript
quickstart.ts
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.hao.ai/v1",
apiKey: "YOUR_HAOAI_API_KEY",
});
async function main() {
const response = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [
{ role: "user", content: "用一句话介绍 HaoAI Gateway" },
],
});
console.log(response.choices[0]?.message?.content);
}
main();Anthropic SDK
Anthropic 原生协议 — 直接使用 Anthropic SDK，完整支持 Claude 全部功能。
cURL
Terminal
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": 512,
"messages": [
{ "role": "user", "content": "用一句话介绍 HaoAI Gateway" }
]
}'Python
quickstart_anthropic.py
import anthropic
client = anthropic.Anthropic(
base_url="https://api.hao.ai/anthropic",
api_key="YOUR_HAOAI_API_KEY",
)
message = client.messages.create(
model="anthropic/claude-sonnet-4.6",
max_tokens=512,
messages=[
{"role": "user", "content": "用一句话介绍 HaoAI Gateway"}
],
)
print(message.content[0].text)TypeScript
quickstart_anthropic.ts
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
baseURL: "https://api.hao.ai/anthropic",
apiKey: "YOUR_HAOAI_API_KEY",
});
async function main() {
const message = await client.messages.create({
model: "anthropic/claude-sonnet-4.6",
max_tokens: 512,
messages: [
{ role: "user", content: "用一句话介绍 HaoAI Gateway" },
],
});
console.log(message.content[0]?.type === "text" ? message.content[0].text : "");
}
main();Gemini SDK
Gemini 原生协议 — 使用 Google GenAI SDK，支持 Gemini 全系模型。
cURL
Terminal
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": [
{ "parts": [{ "text": "用一句话介绍 HaoAI Gateway" }] }
]
}'Python
quickstart_gemini.py
from google import genai
client = genai.Client(
api_key="YOUR_HAOAI_API_KEY",
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="用一句话介绍 HaoAI Gateway",
)
print(response.text)TypeScript
quickstart_gemini.ts
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({
apiKey: "YOUR_HAOAI_API_KEY",
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: "用一句话介绍 HaoAI Gateway",
});
console.log(response.text);
}
main();