documentation
开发者文档
一个 base URL、一个密钥,覆盖对话、图像、视频、语音与 3D。下面标注了哪些内容已验证、哪些还在补。
快速开始
已验证把 base URL 换成网关地址,其余代码不用动。所有区域共用同一套密钥体系。
curl -sX POST https://new-api-ca.waninter.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kimi-k3",
"messages": [{"role": "user", "content": "你是谁?"}]
}'from openai import OpenAI
client = OpenAI(
base_url="https://new-api-ca.waninter.com/v1",
api_key=os.environ["API_KEY"],
)
r = client.chat.completions.create(
model="kimi-k3",
messages=[{"role": "user", "content": "你是谁?"}],
)
print(r.choices[0].message.content)认证
已验证标准 Authorization: Bearer <key>。密钥以 sk-开头,在控制台创建。
另接受 OAuth2 授权方案,部分 SDK 的 OAuth2 封装会发这个 scheme,两者等价。
协议与端点
待补对话类接口已验证可用。下列协议的完整兼容度与例外需要逐个核对后补全:
- OpenAI Chat Completions
POST /v1/chat/completions已验证 - OpenAI Completions
POST /v1/completions待核对 - OpenAI Responses
POST /v1/responses待核对 - OpenAI Images
POST /v1/images/generations待核对 - Anthropic Messages
POST /v1/messages待核对 - Google Gemini
POST /v1beta/models/{model}:generateContent待核对
响应结构
已验证标准 chat.completion。 有两个字段不是 OpenAI 标准,需要特别注意:
{
"id": "chatcmpl-...",
"object": "chat.completion",
"created": 1790499946,
"model": "kimi-k3",
"choices": [{
"index": 0,
"finish_reason": "stop",
"message": {
"role": "assistant",
"content": "我是 Kimi,由月之暗面(Moonshot AI)开发的 AI 助手…",
"reasoning_content": "We need answer in Chinese likely…"
}
}],
"usage": {
"prompt_tokens": 90,
"completion_tokens": 166,
"total_tokens": 256,
"completion_tokens_details": { "reasoning_tokens": 123 },
"prompt_tokens_details": {
"cached_tokens": 0,
"created_cache_tokens": 0
}
}
}prompt_tokens_details.created_cache_tokens
OpenAI 标准里没有这个字段。它表示本次写入缓存的 token 数。也就是说缓存写入与缓存命中 是分开计价的,账单不能只看 cached_tokens。
message.reasoning_content
思考模型的思维链,OpenAI 格式里没有。渲染思考模型时必须处理这个字段, 否则会丢失推理内容或把它混进正文。
媒体生成
待补图像、视频、语音、3D 端点的提交方式、异步任务模型、状态机取值与结果轮询方式 需要按实际实现补全。当前站的样片与工作台也依赖这部分。
计费口径
待补计价单位随模态不同,图像与视频按张/按秒,语音按字符,对话按 token (含缓存写入、缓存命中、推理 token 的独立倍率)。具体的倍率表与预扣规则待补。
已确认:失败、超时与被内容审核拒绝的任务不计费。
区域与可用性
已验证5 个区域站点,自动分组路由。状态页见站内 status 页面。
new-api-ca.waninter.comCA 站new-api-sg.waninter.comSG 站new-api-2.waninter.comSG 中转new-api-hk.waninter.comHK 站llm.waninter.comCN 站
错误与重试
待补错误响应结构、状态码全集、可重试判定、流式中断处理 需要按实际实现补全。这一节在生产前必须写完。
工具链
待补SDK、CLI、MCP Server 与编辑器插件的接入方式待补。
已确认:账号支持 passkey 登录,且覆盖全部 5 个区域域名。
need a key
文档还没写完的部分,控制台里有当前可用的模型与价格。