Developer API Reference · preview

一个地址，调用全部模型。

万川智流提供兼容主流 SDK 使用习惯的统一 API。开发环境当前使用确定性模拟模型，正式上游接入后仍保持相同的调用入口。

API Base · https://api.wanchuanapi.com

接口目录

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只追加资金账本

最小调用示例

API Key 只放在服务端环境变量或密钥管理器中，不要写进浏览器代码。

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

当前仍是开发/外部预览版本：模型、钱包、会话和幂等记录保存在内存中，不得用于真实客户资金结算。生产开放前必须切换到 PostgreSQL 强一致账本。