模驿API

创建对话补全

端点
POST/v1/chat/completions

OpenAI Chat Completions 兼容端点，适用于 GPT 与 Gemini 模型。不建议通过本端点调用 Claude：会丢失 prompt cache、thinking 等能力，请改用创建消息。

请求

请求头 取值 说明
Authorization Bearer sk-moyiapi-xxxxxx 鉴权。也可以改用 x-api-key: sk-moyiapi-xxxxxx
content-type application/json

最小请求体：

json
{
  "model": "gpt-5.6-sol",
  "messages": [
    {"role": "user", "content": "Hello"}
  ]
}

参数

字段 类型 必填 说明
model string 是 GPT 或 Gemini 模型 ID，完整列表见 GET /v1/models
messages array 是 对话消息，role 为 system、user 或 assistant，content 为文本
max_tokens integer 否 最大输出 token 数
stream boolean 否 设为 true 时以 SSE 流式返回，默认 false

其余字段按 OpenAI Chat Completions API 格式透传，用法以 OpenAI 官方文档为准。

响应

非流式返回 chat.completion 对象：

json
{
  "object": "chat.completion",
  "model": "gpt-5.6-sol",
  "choices": [
    {"index": 0, "message": {"role": "assistant", "content": "Hello!"}, "finish_reason": "stop"}
  ],
  "usage": {"prompt_tokens": 214, "completion_tokens": 3, "total_tokens": 217}
}
字段 说明
id 响应 ID
object 固定为 chat.completion
created 创建时间（Unix 秒）
model 实际响应的模型 ID
choices 回复数组，文本在 choices[0].message.content，finish_reason 为停止原因（如 stop）
usage prompt_tokens、completion_tokens、total_tokens；命中缓存时另有 prompt_tokens_details.cached_tokens
service_tier 本次请求实际使用的服务档位

stream 为 true 时返回 data: {...} 分片（object 为 chat.completion.chunk），[DONE] 之前的最后一个分片带 usage，详见流式输出。

示例

基础请求

bash
curl https://api.moyiapi.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-moyiapi-xxxxxx" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

流式请求

bash
curl https://api.moyiapi.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-moyiapi-xxxxxx" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "stream": true,
    "messages": [{"role": "user", "content": "写一句话"}]
  }'

Python SDK

python
from openai import OpenAI

client = OpenAI(
    api_key="sk-moyiapi-xxxxxx",
    base_url="https://api.moyiapi.cn/v1",
)

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

错误

HTTP 状态 error.type 触发条件
401 missing_auth_credential / invalid_api_key / invalid_bearer_token 鉴权失败，详见鉴权
400 model_not_available model 不存在或暂不可用，请对照 GET /v1/models 检查 ID
400 model_not_supported 该模型当前不支持调用，按提示改用其他模型
准备好了？三步即可开始登录控制台 · 购买额度 · 创建 API Key
获取 API Key查看定价
DiscordGet community help instantly
Join Discord
创建对话补全 · 帮助文档