快速开始

3 步上手 xmAI，5 分钟内发送第一个 API 请求。

第 1 步：注册账号

前往 XmAI 控制台 注册账号，注册即赠送免费额度。

第 2 步：获取 API Key

1. 登录 控制台
2. 进入 API Keys 页面
3. 点击 创建新 Key
4. 复制并妥善保存 — 密钥仅显示一次

第 3 步：发送第一个请求

xmAI 完全兼容 OpenAI API，只需将 base_url 改为 https://api.xmai.sg/v1。

Python

from openai import OpenAI

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

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好！"}],
)
print(response.choices[0].message.content)

Node.js

import OpenAI from 'openai'

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

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: '你好！' }],
})
console.log(response.choices[0].message.content)

Go

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	body := map[string]interface{}{
		"model": "gpt-4o",
		"messages": []map[string]string{
			{"role": "user", "content": "你好！"},
		},
	}
	jsonBody, _ := json.Marshal(body)

	req, _ := http.NewRequest("POST",
		"https://api.xmai.sg/v1/chat/completions",
		bytes.NewBuffer(jsonBody))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("Authorization", "Bearer sk-your-xmai-key")

	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
	data, _ := io.ReadAll(resp.Body)
	fmt.Println(string(data))
}

curl

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

从 OpenAI 迁移？

如果你已在使用 OpenAI SDK，只需将 base_url / baseURL 改为 https://api.xmai.sg/v1，无需其他代码改动！

接下来

• 集成指南 — 选一个 CLI/SDK 指南（Claude Code、OpenCode、Codex CLI、Cursor、Cline 等）
• Chat Completions API — 完整 API 参考，支持流式输出
• Messages API — 面向 Claude 模型的 Anthropic 兼容端点
• 模型列表 — 查看可用模型
• 错误码 — 错误处理指南
• 常见问题 — FAQ