OpenAI 兼容接口说明

兼容原理

ChinaWHAPI 的 /v1/chat/completions 端点接受与 OpenAI API 完全相同的请求格式和字段，包括 messages、model、temperature、max_tokens、stream 等。

SDK 接入

只需将 baseURL 改为 ChinaWHAPI 的地址，并传入你的 API Key，即可使用任意 OpenAI 兼容 SDK 调用中国模型。

Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="{your_api_key}",
    base_url="https://chinawhapi.com/v1"
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "解释什么是 RAG"}]
)
print(response.choices[0].message.content)

Node.js 示例

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "{your_api_key}",
  baseURL: "https://chinawhapi.com/v1",
});

const response = await client.chat.completions.create({
  model: "qwen3.6-plus",
  messages: [{ role: "user", content: "帮我写一段代码" }],
});

LangChain 集成

在 LangChain 中使用 ChatOpenAI 并设置 openai_api_base 为 ChinaWHAPI 的地址即可。

适用工具

Cursor、Jan、Cherry Studio、Postman、curl、Python openai 包、Node.js openai 包、LangChain、LlamaIndex、Dify 等所有支持自定义 base URL 的工具。

注意事项

某些模型参数可能不被上游支持（如 deepseek-r1 的 system_fingerprint），ChinaWHAPI 会自动过滤不兼容参数并返回上游实际响应。