文档

接入星模XModel

OpenAI 兼容 API：快速开始、认证、计费与迁移，跟着示例数分钟跑通第一个请求。

代码优先

代码示例

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://modelxing.com/v1"
)

resp = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    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: "deepseek-v4.1-flash",
  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": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "Hello from 星模XModel"}]
  }'

文档索引

文档目录

快速开始

配置 base_url、API Key 和模型 ID 后，即可通过 OpenAI 兼容接口调用已发布模型。

认证

使用账号级 API Key 调用网关，并按环境和业务拆分密钥。

Chat Completions

通过同一种请求结构调用 XModel 已发布的 OpenAI 兼容模型。

流式输出

在模型和路由都支持时使用 SSE 流式输出，并保留用量与中断诊断。

语音合成（TTS）

通过 /v1/audio/speech 从文本生成语音：音色、格式、默认值，以及如何获取各模型的调用契约。

视频生成

提交异步视频作业：人像口播（musetalk-local）、wan2.7 家族与 minimax-h3 参考通道——以及各家族的入参契约。

音色注册

注册设计与克隆音色、分页查询、清理测试残留——以及每个面上真实存在的字段名。

调用契约

每个模态模型都发布机器可读的调用契约：图像尺寸域、Embedding 输出维度、语音识别输入格式与各参数默认值。

模型

查看 XModel 当前公开网关可调用或可对比的模型、价格、来源和能力标签。

错误

处理鉴权、额度、限流和上游错误，并按网关层级排查。

计费

按模型价格、账户余额、Key 策略和限流规则管理生产调用。

OpenAI 迁移

把 OpenAI 或其他 OpenAI-compatible 接入迁移到星模XModel。

决策评估 System One (beta)

把文本、图片、视频或音频变成业务可直接使用的结构化判断——是非概率、分类选择、评分档位，按输入 token 计费。