大语言会话模型接入

概览

OneLinkAI 提供大语言会话模型兼容接口，用于在 OneLinkAI 网关下调用不同协议风格的文本生成与多模态会话能力。整体目标是尽可能兼容主流官方协议，方便已经接入 OpenAI、Anthropic 或 Gemini 协议的业务快速迁移或并行接入。

当前本文档主要覆盖以下四类接口：

OpenAI Chat Completions：兼容 OpenAI 官方 Chat Completions 协议

OpenAI Responses：兼容 OpenAI 官方 Responses API 协议

Claude Messages：兼容 Anthropic 官方 Messages API 协议

Gemini generateContent：兼容 Google Gemini 官方 models.generateContent 协议

接入规则

鉴权方式

调用 OneLinkAI 的大语言会话模型接口时，统一使用 Bearer Token 鉴权：

路径规则

当前大语言会话模型主要使用以下路径：

POST /v1/chat/completions

POST /v1/responses

POST /v1/messages

POST /v1beta/models/{model}:generateContent

示例：

OpenAI Chat Completions 路径：POST /v1/chat/completions

OpenAI Responses 路径：POST /v1/responses

Claude Messages 路径：POST /v1/messages

Gemini generateContent 路径：POST /v1beta/models/{model}:generateContent

通用调用方式

所有接口均使用 application/json 请求体。

不同路径对应不同官方协议格式，建议业务侧按已有 SDK 或客户端协议选择对应接口。

请求体中的 model 或路径参数 {model} 用于指定调用模型，模型 ID 可通过模型列表接口获取。

OneLinkAI 保留统一网关路径与统一 Authorization: Bearer <ApiKey> 鉴权方式。

能力清单

以下内容用于快速说明当前大语言会话模型接口的支持范围。

能力名称	是否支持	说明
OpenAI Chat Completions	✔️	兼容 OpenAI 官方 Chat Completions 协议
OpenAI Responses	✔️	兼容 OpenAI 官方 Responses API 协议
Claude Messages	✔️	兼容 Anthropic 官方 Messages API 协议
Gemini generateContent	✔️	兼容 Google Gemini 官方 models.generateContent 协议

接口详情

以下请求示例统一以 https://api.onelinkai.cloud 作为示例网关地址，实际调用时请替换为你的真实接入地址和有效的 ApiKey。

OpenAI Chat Completions

兼容 OpenAI 官方 Chat Completions 协议的对话补全接口

请求路径：POST /v1/chat/completions

请求格式：application/json

必填请求字段：model、messages

常用请求字段：temperature、top_p、stream、stop、max_completion_tokens、response_format、tools、tool_choice、seed

核心响应字段：id、object、created、model、choices、usage

请求示例

OpenAI Responses

兼容 OpenAI 官方 Responses API 协议的统一生成接口

请求路径：POST /v1/responses

请求格式：application/json

必填请求字段：model、input

常用请求字段：instructions、max_output_tokens、temperature、top_p、store、stream、previous_response_id、text、tools、tool_choice

核心响应字段：id、object、created_at、status、model、output、usage

请求示例

Claude Messages

兼容 Anthropic 官方 Messages API 协议的消息生成接口

请求路径：POST /v1/messages

请求格式：application/json

必填请求字段：model、max_tokens、messages

常用请求字段：system、metadata、stop_sequences、stream、temperature、top_p、top_k、thinking、tools、tool_choice

核心响应字段：id、type、role、content、model、stop_reason、stop_sequence、usage

请求示例

Gemini generateContent

兼容 Google Gemini 官方 models.generateContent 协议的非流式生成接口

请求路径：POST /v1beta/models/{model}:generateContent

请求格式：application/json

路径参数：model

必填请求字段：contents

常用请求字段：systemInstruction、tools、toolConfig、safetySettings、generationConfig、cachedContent

核心响应字段：candidates、promptFeedback、usageMetadata、modelVersion

请求示例

接口清单

使用建议

如果你的业务侧已经使用 OpenAI Chat Completions SDK，建议优先使用 POST /v1/chat/completions。

如果你希望使用 OpenAI 新版统一生成协议，建议优先使用 POST /v1/responses。

如果你的业务侧已经使用 Anthropic Messages 协议，建议优先使用 POST /v1/messages。

如果你的业务侧使用 Gemini 原生协议或 Gemini 风格客户端，建议优先使用 POST /v1beta/models/{model}:generateContent。

跨协议迁移时，建议先保持原请求体结构不变，仅替换网关地址和鉴权方式，再逐步适配工具调用、结构化输出、多模态输入等高级能力。

具体模型可用性、字段约束、流式行为与错误返回，请以当前接口实际返回结果为准。

概览#

接入规则#

鉴权方式#

路径规则#

通用调用方式#

能力清单#

接口详情#

OpenAI Chat Completions#

请求示例#

OpenAI Responses#

请求示例#

Claude Messages#

请求示例#

Gemini generateContent#

请求示例#

接口清单#

使用建议#

概览

接入规则

鉴权方式

路径规则

通用调用方式

能力清单

接口详情

OpenAI Chat Completions

请求示例

OpenAI Responses

请求示例

Claude Messages

请求示例

Gemini generateContent

请求示例

接口清单

使用建议