API 文档

XHuoAPI 的接口兼容 OpenAI Chat Completions 格式，Claude 模型另外支持 Anthropic Messages 格式，一个 Key 可调用 70+ 模型。

交互式 API 参考（可在线调试）→

Base URL

https://api.xhuoapi.ai

快速开始

  1. 访问 控制台 注册账号
  2. 在控制台获取您的 API Key
  3. 将 Base URL 替换为 https://api.xhuoapi.ai
  4. 开始调用 API

支持的接口

下表每一项都用真实 API Key 实测过。表里没有的接口，即使路径有响应，也不保证可用。

最近实测: · Base URL https://api.xhuoapi.ai

接口 格式 说明
POST /v1/chat/completions OpenAI 全部对话模型。stream、tools、response_format 已在 deepseek-v3.2 上验证，其他模型是否支持以厂商为准。
POST /v1/messages Anthropic Claude 模型（实测 claude-sonnet-4-6）。认证用 x-api-key 或 Authorization: Bearer 都可以。
GET /v1/models OpenAI 列出当前 Key 可用的全部模型。
POST /v1/embeddings OpenAI text-embedding-3-small 返回 1536 维向量。目录里另有 text-embedding-3-large 和 text-embedding-ada-002（未单独实测）。

OpenAI SDK 的 base_url 填 https://api.xhuoapi.ai/v1；Anthropic SDK 填 https://api.xhuoapi.ai，SDK 会自己补上 /v1/messages。

认证方式

所有 API 请求都需要在 HTTP Header 中携带 API Key：

Authorization: Bearer YOUR_API_KEY

⚠️ 安全提示：请勿在客户端代码中暴露您的 API Key，建议通过后端服务器代理请求。

对话补全

创建一个对话补全请求，支持所有主流模型。

POST /v1/chat/completions

请求参数

参数 类型 必填 说明
model string ✅ 模型名称，如 gpt-4o
messages array ✅ 对话消息列表
temperature number ❌ 采样温度 (0-2)，默认 1
max_tokens integer ❌ 最大生成 token 数
stream boolean ❌ 是否流式输出，默认 false

请求示例

curl https://api.xhuoapi.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": "你好，介绍一下你自己"
      }
    ],
    "temperature": 0.7
  }'

响应示例

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好！我是一个AI助手..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 20,
    "total_tokens": 32
  }
}

模型列表

获取所有可用模型列表。

GET /v1/models

请求示例

curl https://api.xhuoapi.ai/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

实测可用的常用模型

以下模型在最近一次实测中可以正常调用（日期见「支持的接口」）。完整清单和各分组价格见定价页。

deepseek-v3.2

DeepSeek

qwen3.8-max

Alibaba · Qwen

glm-5.3

Zhipu · GLM

kimi-k3

Moonshot · Kimi

claude-sonnet-4-6

Anthropic

gpt-4.1-mini

OpenAI

gemini-2.5-flash

Google

流式输出

通过设置 stream: true 启用流式输出，实时接收生成内容。

请求示例

curl https://api.xhuoapi.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "讲个笑话"}],
    "stream": true
  }'

响应格式

流式响应使用 Server-Sent Events (SSE) 格式，每行以 data: 开头：

data: {"id":"chatcmpl-123","choices":[{"delta":{"content":"你"}}]}

data: {"id":"chatcmpl-123","choices":[{"delta":{"content":"好"}}]}

data: [DONE]

工具调用与 JSON 模式

按 OpenAI 格式传 tools，模型会在 message.tool_calls 里返回要调用的函数和参数。下面这个请求实测返回 get_weather，参数是 {"city": "Paris"}。

curl https://api.xhuoapi.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "deepseek-v3.2",
    "messages": [{"role": "user", "content": "What is the weather in Paris? Use the tool."}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get weather for a city",
        "parameters": {"type": "object", "properties": {"city": {"type": "string"}}, "required": ["city"]}
      }
    }],
    "tool_choice": "auto"
  }'

传 "response_format": {"type": "json_object"}，模型只输出合法 JSON。提示词里也写明要返回 JSON，结果更稳定。

curl https://api.xhuoapi.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "deepseek-v3.2",
    "messages": [{"role": "user", "content": "Return this JSON exactly: {\"ok\": true}"}],
    "response_format": {"type": "json_object"}
  }'

Anthropic Messages 格式

Claude 模型可以直接用 Anthropic 的请求格式和 Anthropic SDK 调用，已经基于 Anthropic SDK 写好的代码只需要改 base_url 和 Key。

POST /v1/messages

两种认证头都实测可用：x-api-key: YOUR_API_KEY 或 Authorization: Bearer YOUR_API_KEY。示例里的 anthropic-version 头由 Anthropic SDK 自动添加。

curl https://api.xhuoapi.ai/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Python (anthropic SDK)

from anthropic import Anthropic

client = Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.xhuoapi.ai",
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
)
print(message.content[0].text)

向量嵌入

请求和返回格式与 OpenAI 的 /v1/embeddings 相同。text-embedding-3-small 返回 1536 维向量。

POST /v1/embeddings 
curl https://api.xhuoapi.ai/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"model": "text-embedding-3-small", "input": "hello"}'

错误处理

API 使用标准 HTTP 状态码表示请求结果。

状态码 说明
200 请求成功
400 请求参数错误
401 API Key 无效或未提供
429 请求频率超限
404 接口路径不存在，通常是地址拼错了
503 该模型当前没有可用的上游，或模型名不存在。可以稍后重试，或换一个模型
500 服务器内部错误

错误响应示例

{
  "error": {
    "code": "",
    "message": "Invalid token (request id: ...)",
    "type": "new_api_error"
  }
}

error.message 的具体文字可能变化，代码里请按 HTTP 状态码处理，不要匹配 message 的文字。

代码示例

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.xhuoapi.ai/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: 'YOUR_API_KEY',
  baseURL: 'https://api.xhuoapi.ai/v1'
});

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

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

cURL

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

需要帮助？访问 控制台 或发邮件至 support@xhuoapi.ai

© 2026 XHuoAPI. All rights reserved.