Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mercury-eab3b728.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

文字系列

文字系列覆盖 OpenAI 兼容文本接口、Claude 原生消息接口、Gemini 原生接口、OpenAI Responses、多模态输入、Embedding、Rerank、Moderation 与网页工具。

通用对话

POST /v1/chat/completions,适合聊天、Agent、长文本生成和多模态输入。

OpenAI Responses

POST /v1/responses,适合工具调用、结构化输出和上下文续接。

Claude 原生

POST /v1/messages,保留 Anthropic Messages 协议。

Gemini 原生

POST /v1beta/models/{model}:{action}GET /v1beta/models

认证方式

大多数文字 relay 接口使用 Bearer Token:
Authorization: Bearer YOUR_API_KEY
Claude 原生格式同时兼容:
x-api-key: YOUR_API_KEY
anthropic-version: 2023-06-01
Gemini 原生格式同时兼容:
x-goog-api-key: YOUR_API_KEY

接口清单

MethodPath页面说明
POST/v1/chat/completions通用对话接口(默认流式)OpenAI Chat Completions 兼容格式,文档默认展示流式调用
POST/v1/chat/completions通用对话接口(默认非流式)同一路由的非流式写法
POST/v1/completions文本补全接口Legacy Completions 兼容格式
POST/v1/messagesClaude 消息接口Anthropic Messages 原生协议
POST/v1/responsesOpenAI 多模态响应接口Responses API
POST/v1/responses/compactOpenAI 多模态响应接口上下文压缩
POST/v1/embeddings向量接口OpenAI Embeddings 兼容格式
POST/v1/engines/{model}/embeddings向量接口Legacy embedding 路径
POST/v1/rerank重排序接口文档相关性重排序
POST/v1/moderations内容审核接口OpenAI Moderations 兼容格式
POST/v1/web-reader/read网页工具接口网页读取
POST/v1/web-search/search网页工具接口网页搜索
GET/v1/realtimeRealtime 接口OpenAI Realtime 兼容 WebSocket
GET/v1/models模型列表OpenAI/Claude/Gemini 兼容模型列表
GET/v1/models/{model}模型列表单模型查询
GET/v1beta/modelsGemini 原生格式Gemini 原生模型列表
POST/v1beta/models/{model}:{action}Gemini 原生格式Gemini 原生推理与图像/视频相关动作
GET/v1beta/openai/models模型列表Gemini 兼容模型列表
POST/pg/chat/completions通用对话接口(默认非流式)Playground 调试路由,使用登录态而非 API Key

通用错误码

状态码说明
400请求参数错误,例如模型名不存在、消息结构无效、工具定义不合法
401API Key 缺失、无效或过期
402额度不足
413请求体过大
429请求频率超限
500服务端内部错误
503上游不可用或系统临时过载
如果接口页里标记了“可选”参数,不代表所有模型都支持该字段。最终是否透传、是否生效,仍取决于实际分发到的渠道能力。

推荐阅读顺序

  1. 通用对话接口(默认流式)
  2. OpenAI 多模态响应接口
  3. Claude 消息接口
  4. Gemini 原生格式
  5. 模型列表