Developer API Reference / preview

清晰的接口，
连接持续扩展的模型能力。

统一请求格式覆盖聊天、Responses、模型目录、余额、用量与账本。客户账号审核通过后，可在控制台创建 API Key 并开始联调。

API BASE URLhttps://api.wanchuanapi.com

接口目录

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

GET/healthz公开服务健康状态
GET/v1/models获取当前租户实际可调用的模型目录
POST/v1/chat/completionsChat Completions 兼容接口，支持 SSE 流式输出
POST/v1/responses统一 Responses 接口
GET/v1/balance余额、冻结额度与可用积分
GET/v1/usage当前租户的请求用量与计费记录
GET/v1/ledger当前租户的只追加资金账本

四步接入

1申请试用、个人或企业账号
2等待平台管理员审核
3登录控制台创建 API Key
4服务端发送第一个请求
Chat CompletionscURL
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 强一致账本并接入真实上游。