代码优先
代码示例
Python
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://modelxing.com/v1"
)
resp = client.chat.completions.create(
model="qwen/qwen3-max",
messages=[{"role": "user", "content": "Hello from 星模XModel"}]
)
print(resp.choices[0].message.content)Node
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.NEXTMODEL_API_KEY,
baseURL: "https://modelxing.com/v1",
});
const response = await client.chat.completions.create({
model: "qwen/qwen3-max",
messages: [{ role: "user", content: "Hello from 星模XModel" }],
});
console.log(response.choices[0].message.content);curl
curl https://modelxing.com/v1/chat/completions \
-H "Authorization: Bearer $NEXTMODEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen/qwen3-max",
"messages": [{"role": "user", "content": "Hello from 星模XModel"}]
}'文档索引
文档目录
快速开始
配置 base_url、API Key 和模型 ID 后,即可通过 OpenAI 兼容接口调用已发布模型。
认证
使用账号级 API Key 调用网关,并按环境和业务拆分密钥。
Chat Completions
通过同一种请求结构调用 XModel 已发布的 OpenAI 兼容模型。
流式输出
在模型和路由都支持时使用 SSE 流式输出,并保留用量与中断诊断。
语音合成(TTS)
通过 /v1/audio/speech 从文本生成语音:音色、格式、默认值,以及如何获取各模型的调用契约。
调用契约
每个模态模型都发布机器可读的调用契约:图像尺寸域、Embedding 输出维度、语音识别输入格式与各参数默认值。
模型
查看 XModel 当前公开网关可调用或可对比的模型、价格、来源和能力标签。
错误
处理鉴权、额度、限流和上游错误,并按网关层级排查。
计费
按模型价格、账户余额、Key 策略和限流规则管理生产调用。
OpenAI 迁移
把 OpenAI 或其他 OpenAI-compatible 接入迁移到星模XModel。