#接口总览与鉴权

所有接口的生产入口为 https://www.wanmoapi.com。OpenAI 兼容 SDK 通常把 base_url 设置为 https://www.wanmoapi.com/v1。

如果你只是配置客户端，优先看客户端接入。如果你要自己写代码或调试请求体，再看本页和接口参考。

#先理解三层地址

多数 SDK 只需要 Base URL，不需要你手动拼完整路径。

#鉴权

大多数 OpenAI 兼容接口使用 Bearer Token：

Authorization: Bearer sk-...

OpenAI SDK 示例：

from openai import OpenAI

client = OpenAI(
    api_key="sk-...",
    base_url="https://www.wanmoapi.com/v1",
)

Claude Messages 协议也可使用 Anthropic 风格请求头：

x-api-key: sk-...
anthropic-version: 2023-06-01

#支持的接口族

#最小请求示例

#Chat Completions

curl https://www.wanmoapi.com/v1/chat/completions \
  -H "Authorization: Bearer $WANMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      { "role": "user", "content": "你好" }
    ]
  }'

#Models

curl https://www.wanmoapi.com/v1/models \
  -H "Authorization: Bearer $WANMO_API_KEY"

#Embeddings

curl https://www.wanmoapi.com/v1/embeddings \
  -H "Authorization: Bearer $WANMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "你的-embedding-模型",
    "input": "这是一段要转向量的文本"
  }'

Windows PowerShell 用户请把 $WANMO_API_KEY 改成 $env:WANMO_API_KEY。

#怎么在线调试

1. 打开在线调试。
2. 填写 API Key 和模型名。
3. 输入最小 Prompt。
4. 点击发送。
5. 回到控制台调用日志核对请求。

#接口文档怎么维护

接口参考不是手写表格，而是构建时从仓库根目录的 OpenAPI 文件同步：

docs/openapi/relay.json
  -> docs-site/docs/public/openapi/relay.json
  -> /api-reference/reference

如果接口实现发生变化，先更新 docs/openapi/relay.json，再在 docs-site/ 运行：

bun run sync
bun run build

docs-site/docs/public/openapi/relay.json 是同步产物，不建议手动长期维护；真正的数据源仍是根目录的 docs/openapi/relay.json。

#下一步

• 想查看接口字段：看接口参考。
• 想先用聊天方式验证 Key：看在线调试。
• 不确定协议：看协议选择指南。