七牛云 AI 大模型推理服务的接入点介绍、区域分布及 API 兼容性说明。

服务接入点

七牛云 AI 大模型推理服务提供多个服务接入点，支持国内外用户就近接入，同时兼容 OpenAI、Anthropic、Vertex/Gemini 等主流 AI 平台的 API 协议，最大程度降低迁移和集成成本。

接入点概览

服务接入点（Endpoint / Base URL）是所有 API 请求的起始地址。根据您的网络环境和业务所在区域，选择合适的接入点可以获得更低的延迟和更高的稳定性。

区域	Base URL	说明
国内	`https://api.qnaigc.com`	面向中国大陆用户，延迟更低
海外	`https://api.modelink.ai`	面向海外用户或需要访问境外模型

国内接入点

Base URL：https://api.qnaigc.com

适用于中国大陆地区的用户和业务，连接七牛云国内节点，具有更低的网络延迟。大多数场景推荐优先使用此接入点。

海外接入点

Base URL：https://api.modelink.ai

适用于海外部署的业务或需要通过海外节点访问特定模型的场景。与国内接入点提供完全相同的 API 接口和模型支持。

API 兼容性

七牛云 AI 大模型推理服务对主流 AI 平台的 API 协议提供广泛兼容，您无需重写代码即可从其他平台迁移。

基础协议：OpenAI Chat Completions

接口路径： POST /v1/chat/completions

这是服务的核心接口，完全兼容 OpenAI 的 Chat Completions 规范，支持文本对话、流式输出、函数调用等能力，覆盖平台上绝大多数模型（包括 Claude、Gemini、DeepSeek、Qwen 等各厂商模型）。

只需将 base_url 替换为七牛云接入点、api_key 替换为七牛云 API Key，其余代码无需修改：

从 OpenAI 迁移：

原厂直通接口（Bypass）

Bypass 接口是在基础协议之外提供的补充能力。与 /v1/chat/completions 的统一协议转换不同，bypass 接口将请求直接透传至对应厂商的原生协议，不做格式转换，因此可以使用该厂商 API 的全部原生特性，例如 Anthropic 的 Extended Thinking、Gemini 的 googleSearch 工具等。

两种接入方式的对比：

	基础协议（`/v1/chat/completions`）	原厂直通（`/bypass/...`）
协议格式	OpenAI Chat Completions	各厂商原生协议
模型覆盖	平台全量模型	对应厂商的官方模型
原生特性支持	通用能力	厂商完整原生特性
迁移成本	极低，换 URL 即可	需使用厂商原生 SDK

Bypass Anthropic

接口路径： POST /bypass/anthropic/v1/messages

以 Anthropic Messages API 原生协议调用 Claude 系列模型，支持 Extended Thinking、Prompt Caching、联网搜索等 Claude 特有能力。支持 Anthropic 官方提供的 Claude 系列模型（如 claude-sonnet-4-6、claude-opus-4-6 等）。

Bypass Vertex / Gemini

接口路径： POST /bypass/vertex/v1/models/{model}:{invokeFuncName}

以 Vertex AI / Gemini 原生协议调用 Gemini 系列模型，支持 googleSearch、代码执行等 Gemini 原生工具。支持 Google 官方提供的 Gemini 系列模型（如 gemini-2.5-pro、gemini-3.1-pro-preview 等）。

Bypass OpenAI Responses

接口路径： POST /bypass/openai/v1/responses

以 OpenAI Responses API 原生协议调用 GPT 系列模型，支持联网搜索（web_search_preview）、多轮状态管理等功能。支持 OpenAI 官方提供的 GPT 系列模型（如 openai/gpt-5、openai/gpt-5.5 等）。

各接口路径汇总

接口类型	路径	协议格式
聊天补全（标准）	`POST /v1/chat/completions`	OpenAI Chat Completions
Anthropic 原厂直通	`POST /bypass/anthropic/v1/messages`	Anthropic Messages API
Vertex/Gemini 原厂直通	`POST /bypass/vertex/v1/models/{model}:{func}`	Vertex AI / Gemini API
OpenAI Responses 原厂直通	`POST /bypass/openai/v1/responses`	OpenAI Responses API
视频、图像等生成接口	以各模型接入文档为准	七牛云自定义
模型列表	`GET /v1/models`	OpenAI 兼容

关于视频、图像等多模态生成接口： 接入点（Base URL）与上方一致，具体接口路径、请求参数及返回格式因模型而异，请参考各模型的接入文档。

认证方式

所有 AI 模型调用接口（聊天、视频、图像等）使用 API Key 进行认证：

获取 API Key： 登录七牛云控制台 → AI 大模型推理 → API Key，即可创建或复制密钥。

接入点选择建议

场景	推荐接入点
中国大陆业务	`https://api.qnaigc.com`
海外部署 / 跨境访问	`https://api.modelink.ai`
高延迟敏感场景	就近选择，优先国内接入点

提示： 两个 AI 模型接入点（国内/海外）提供完全一致的接口规范，仅网络路由不同，可按需灵活切换。

服务接入点

服务接入点#

接入点概览#

国内接入点#

海外接入点#

API 兼容性#

基础协议：OpenAI Chat Completions#

原厂直通接口（Bypass）#

Bypass Anthropic#

Bypass Vertex / Gemini#

Bypass OpenAI Responses#

各接口路径汇总#

认证方式#

接入点选择建议#

服务接入点

接入点概览

国内接入点

海外接入点

API 兼容性

基础协议：OpenAI Chat Completions

原厂直通接口（Bypass）

Bypass Anthropic

Bypass Vertex / Gemini

Bypass OpenAI Responses

各接口路径汇总

认证方式

接入点选择建议