万次元AI
get key

documentation

开发者文档

一个 base URL、一个密钥,覆盖对话、图像、视频、语音与 3D。下面标注了哪些内容已验证、哪些还在补。

快速开始

已验证

把 base URL 换成网关地址,其余代码不用动。所有区域共用同一套密钥体系。

curlchat completions
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": "你是谁?"}]
  }'
pythonopenai sdk
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 CompletionsPOST /v1/chat/completions已验证
  • OpenAI CompletionsPOST /v1/completions待核对
  • OpenAI ResponsesPOST /v1/responses待核对
  • OpenAI ImagesPOST /v1/images/generations待核对
  • Anthropic MessagesPOST /v1/messages待核对
  • Google GeminiPOST /v1beta/models/{model}:generateContent待核对

响应结构

已验证

标准 chat.completion。 有两个字段不是 OpenAI 标准,需要特别注意:

response两个非标准字段
{
  "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

文档还没写完的部分,控制台里有当前可用的模型与价格。

进入控制台