接口参考

这里展示常用接口的路径、认证方式、请求参数、响应结构和调用示例。完整 OpenAPI 数据来自仓库内 docs/openapi/relay.json，构建时同步到文档站静态目录。

使用前准备

项目	说明
API Key	在控制台创建，形如 `sk-...`
Base URL	OpenAI 兼容接口通常为 `https://www.wanmoapi.com/v1`
模型名	以控制台和 `/v1/models` 可用列表为准
测试令牌	建议单独创建 `docs-test` 并设置额度

调试注意事项

在线调试会真实请求万模API，可能产生消耗。
不要在公共电脑或共享屏幕里暴露 API Key。
如果接口需要完整 endpoint，确认路径没有重复 /v1。
请求失败时，优先查看控制台调用日志里的原始错误。

常用入口

目标	优先查看
普通聊天	Chat Completions
Codex / Agent	Responses
Claude Code	Claude Messages
Dify / 知识库	Chat Completions + Embeddings
图片生成	Images
视频生成	Videos / Kling / Jimeng

万模API

API 参考

常用接口、认证方式、请求参数和响应结构

OpenAPI JSON 在线调试

调用前检查：Base URL 使用 https://www.wanmoapi.com/v1；API Key 使用控制台创建的 sk-...；模型名以控制台可用模型为准。

POST

聊天

OpenAI Chat

/v1/chat/completions

创建聊天补全

适合 ChatBox、Cherry Studio、Dify、沉浸式翻译和常见 OpenAI SDK。大多数桌面聊天客户端优先使用这个接口。

Authorization

BearerAuth

AuthorizationBearer <token>

在控制台创建 API Key 后，通过请求头传入。OpenAI 兼容接口使用 Authorization: Bearer sk-...。

Request Body

application/json

model*string

模型名，以控制台可用模型或 /v1/models 返回为准。

messages*array<object>

对话消息数组，至少包含一条 role 为 user 的消息。

streamboolean

是否启用 SSE 流式响应。

temperaturenumber

采样温度。未指定时使用上游默认值。

Response Body

200 application/json

idstring

本次响应 ID。

choicesarray<object>

模型回复列表，通常读取 choices[0].message.content。

usageobject

Token 用量，控制台会按此记录消耗。

示例请求

curl https://www.wanmoapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {"role": "user", "content": "你好，用一句话介绍你自己"}
    ]
  }'

响应示例

{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好，我是一个可以帮助你处理文本、代码和知识检索的 AI 助手。"
      }
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 24,
    "total_tokens": 42
  }
}

POST

聊天

OpenAI Responses

/v1/responses

创建 Responses 响应

适合 Codex、Agent 工作流、工具调用和多步任务。需要 Responses 协议的客户端不要改用 Chat Completions。

Authorization

BearerAuth

AuthorizationBearer <token>

在控制台创建 API Key 后，通过请求头传入。OpenAI 兼容接口使用 Authorization: Bearer sk-...。

Request Body

application/json

model*string

Responses 可用模型名。

input*string | array<object>

用户输入内容，可以是字符串或结构化消息数组。

instructionsstring

系统级指令，用于约束回复风格和任务边界。

streamboolean

是否返回流式事件。

toolsarray<object>

工具定义，供 Agent 或函数调用场景使用。

Response Body

200 application/json

idstring

Responses 响应 ID，可用于多轮任务关联。

outputarray<object>

模型输出块，文本通常在 output_text 或 output 内容中读取。

usageobject

Token 用量和计费依据。

示例请求

curl https://www.wanmoapi.com/v1/responses \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "input": "检查这个项目的 README 是否说明了启动方式"
  }'

响应示例

{
  "id": "resp_xxx",
  "object": "response",
  "output_text": "README 中已经包含本地启动方式，建议补充环境变量说明。",
  "usage": {
    "input_tokens": 26,
    "output_tokens": 18,
    "total_tokens": 44
  }
}

POST

Claude

Claude Messages

/v1/messages

创建 Claude 消息

适合 Claude Code、Anthropic SDK 和选择 Anthropic 模式的客户端。Base URL 通常填写到域名，不额外拼 /v1。

Authorization

BearerAuth

AuthorizationBearer <token>

在控制台创建 API Key 后，通过请求头传入。OpenAI 兼容接口使用 Authorization: Bearer sk-...。

Request Body

application/json

model*string

Claude 协议可用模型名。

messages*array<object>

Claude Messages 格式的消息数组。

max_tokens*integer

最大输出 Token 数。

systemstring

系统提示词。

Response Body

200 application/json

idstring

消息 ID。

contentarray<object>

回复内容块。

usageobject

输入和输出 Token 用量。

示例请求

curl https://www.wanmoapi.com/v1/messages \
  -H "x-api-key: sk-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 512,
    "messages": [
      {"role": "user", "content": "用一句话说明 Claude Messages 协议"}
    ]
  }'

响应示例

{
  "id": "msg_xxx",
  "type": "message",
  "role": "assistant",
  "content": [
    {"type": "text", "text": "Claude Messages 是 Anthropic 风格的对话请求格式。"}
  ],
  "usage": {
    "input_tokens": 20,
    "output_tokens": 18
  }
}

POST

Gemini

Gemini Generate Content

/v1beta/models/{model}:generateContent

Gemini 原生生成

适合 Gemini SDK、Gemini CLI 和原生 Gemini 生态。路径中的 {model} 需要替换为实际模型名。

Authorization

BearerAuth

AuthorizationBearer <token>

在控制台创建 API Key 后，通过请求头传入。OpenAI 兼容接口使用 Authorization: Bearer sk-...。

Request Body

application/json

contents*array<object>

Gemini 原生内容数组。

generationConfigobject

温度、最大输出长度等生成配置。

Response Body

200 application/json

candidatesarray<object>

候选回复列表。

usageMetadataobject

Gemini 原生用量信息。

示例请求

curl "https://www.wanmoapi.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"parts": [{"text": "你好"}]}
    ]
  }'

响应示例

{
  "candidates": [
    {
      "content": {
        "parts": [{"text": "你好，有什么我可以帮你？"}]
      }
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 4,
    "candidatesTokenCount": 10,
    "totalTokenCount": 14
  }
}

POST

向量

Embeddings

/v1/embeddings

创建文本向量

适合 Dify、AnythingLLM、知识库和检索增强场景。Embedding 模型通常需要和聊天模型分开选择。

Authorization

BearerAuth

AuthorizationBearer <token>

在控制台创建 API Key 后，通过请求头传入。OpenAI 兼容接口使用 Authorization: Bearer sk-...。

Request Body

application/json

model*string

Embedding 模型名。

input*string | array<string>

需要转成向量的文本。

Response Body

200 application/json

dataarray<object>

向量数组。

usageobject

Token 用量。

示例请求

curl https://www.wanmoapi.com/v1/embeddings \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "万模API 文档"
  }'

响应示例

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0123, -0.0456, 0.0789]
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "total_tokens": 8
  }
}

GET

模型

Models

/v1/models

获取模型列表

用于验证 API Key 是否可用，并查看当前令牌分组下可调用的模型。客户端配置前建议先调用一次。

Authorization

BearerAuth

AuthorizationBearer <token>

在控制台创建 API Key 后，通过请求头传入。OpenAI 兼容接口使用 Authorization: Bearer sk-...。

Request Body

无请求体

这个接口不需要 JSON 请求体。

Response Body

200 application/json

dataarray<object>

模型列表，读取 id 作为模型名。

objectstring

固定为 list。

示例请求

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

响应示例

{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.4-mini",
      "object": "model"
    }
  ]
}

#接口参考

#使用前准备

#调试注意事项

#常用入口

OpenAI Chat

创建聊天补全

Authorization

Request Body

Response Body

OpenAI Responses

创建 Responses 响应

Authorization

Request Body

Response Body

Claude Messages

创建 Claude 消息

Authorization

Request Body

Response Body

Gemini Generate Content

Gemini 原生生成

Authorization

Request Body

Response Body

Embeddings

创建文本向量

Authorization

Request Body

Response Body

Models

获取模型列表

Authorization

Request Body

Response Body

接口参考

使用前准备

调试注意事项

常用入口