Developer API Reference · preview

一个接口，连接多种模型能力。

使用统一的请求格式调用文本、推理及后续多模态能力。客户账号审核通过后，可在控制台创建 API Key、查看模型目录、用量和余额。

API BASE URLhttps://api.wanchuanapi.com

接口目录

除健康检查外，所有业务接口都需在 Authorization 请求头中携带客户 API Key。

GET/healthz公开健康状态

GET/v1/models获取当前租户可调用的模型目录

POST/v1/chat/completions兼容 Chat Completions，支持 SSE 流式输出

POST/v1/responses统一 Responses 接口

GET/v1/balance余额、冻结额度与可用积分

GET/v1/usage请求用量与计费记录

GET/v1/ledger只追加资金账本

接入流程

企业客户可自助提交注册申请，由平台管理员审核开通。

1注册企业客户账号

2等待管理员审核

3登录并创建 API Key

4服务端发起首次请求

最小调用示例

API Key 只应保存在服务端环境变量或企业密钥管理器中。

curl "https://api.wanchuanapi.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: UNIQUE_REQUEST_ID" \
  -d '{
    "model": "omni/mock-text-v1",
    "messages": [{"role":"user","content":"生成一条商品卖点"}],
    "max_tokens": 256
  }'

当前为外部预览环境：模型、客户、钱包、会话和账本记录暂存内存，服务重启会重置；不可用于真实客户资金结算。正式开放前必须切换到 PostgreSQL 强一致账本和真实上游。