文本通用接口

文本对话（OpenAI Chat Completions）

兼容 OpenAI Chat Completions 协议，所有文本对话模型（GPT、Claude、Gemini、DeepSeek、Qwen、GLM 等）通过本接口调用，切换 model 字段即可。

接入地址

线路	Base URL	说明
国内加速（推荐）	`https://cdn.wusag.com`	走国内 CDN 节点
海外直连	`https://api.xinliu.one`	海外服务器或加速节点异常时使用

两个地址共用同一账户和 Key。

请求

方法：POST {Base URL}/v1/chat/completions

Header：

Authorization: Bearer 你的令牌

Content-Type: application/json

参数

字段	类型	必填	说明
`model`	string	是	模型名，调 `GET /v1/models` 拉取真实列表，常见：`gpt-4o-mini` `gpt-4o` `claude-opus-4-7` `claude-sonnet-4-6` `deepseek-v4-pro` `qwen3.6-plus` `glm-5.1` 等
`messages`	array	是	对话历史，元素 `{role, content}`，role 取 `system` / `user` / `assistant` / `tool`
`stream`	bool	否	流式返回，默认 `false`。设 `true` 时按 SSE 推送
`temperature`	number	否	0~2，默认 1
`max_tokens`	int	否	单次最大输出 token 数
`top_p`	number	否	核采样，0~1
`tools`	array	否	Function Calling 工具列表
`response_format`	object	否	响应格式约束，如 `{"type": "json_object"}`

多模态（视觉）

图片放在 messages[].content 数组里：

{
  "content": [
    {"type": "text", "text": "这张图是什么"},
    {"type": "image_url", "image_url": {"url": "https://xxx.jpg"}}
  ]
}

流式返回

设 "stream": true，服务端返回 text/event-stream，每行 data: {chunk_json}，最后 data: [DONE] 结束。

计费

按 prompt_tokens + completion_tokens × 模型倍率，详见后台「模型价格」。

错误码

401 令牌无效或未提供

402 余额不足

404 模型不存在或未开通

429 速率限制

500 服务端错误

请求示例

流式请求示例

返回示例

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1778068950,
  "model": "gpt-4o-mini",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "你好！"},
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 13,
    "completion_tokens": 3,
    "total_tokens": 16
  }
}

Python SDK 示例

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json

示例

{
    "model": "string",
    "messages": [
        {
            "role": "string",
            "content": "string"
        }
    ],
    "stream": true,
    "temperature": 0,
    "max_tokens": 0
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

文本对话（OpenAI Chat Completions）#

接入地址#

请求#

参数#

多模态（视觉）#

流式返回#

计费#

错误码#

请求示例#

流式请求示例#

返回示例#

Python SDK 示例#