Modelink

服务接入点

服务接入点（Endpoint / Base URL）是所有模型请求的起始地址。接入 Modelink 前，需要先根据业务所在区域、服务器部署位置和网络环境选择合适的接入点，再确认客户端使用的协议兼容方式。

接入点概览

区域Base URL推荐场景
中国大陆https://api.qnaigc.com面向中国大陆用户和部署在中国大陆网络环境中的业务，通常可获得更低延迟
海外https://api.modelink.ai面向海外部署、跨境访问或需要访问境外模型的业务

两个接入点提供一致的接口规范和模型能力，主要区别是网络路由和访问区域。生产环境建议将 Base URL 配置为环境变量，便于灰度切换、故障切换和多区域部署。

信息

如果不确定选择哪个接入点，优先按服务端所在区域选择；延迟敏感业务应在目标部署环境中分别测试两个接入点的可用性、耗时和稳定性。

中国大陆接入点

中国大陆业务可以使用：

https://api.qnaigc.com

OpenAI 兼容 SDK 或工具通常填写带 /v1 的 Base URL：

https://api.qnaigc.com/v1

Anthropic 兼容 SDK 或工具通常填写不带 /v1 的 Base URL，具体以对应客户端配置项要求为准：

https://api.qnaigc.com

海外接入点

海外部署、跨境访问或需要访问境外模型的业务可以使用：

https://api.modelink.ai

OpenAI 兼容 SDK 或工具通常填写带 /v1 的 Base URL：

https://api.modelink.ai/v1

Anthropic 兼容 SDK 或工具通常填写不带 /v1 的 Base URL，具体以对应客户端配置项要求为准：

https://api.modelink.ai

API 兼容性

Modelink 面向主流大模型生态提供兼容能力，便于从已有客户端、SDK 或业务代码迁移。

基础协议：OpenAI Chat Completions

OpenAI Chat Completions 兼容方式适合通用对话、文本生成、流式输出、函数调用和大多数第三方客户端迁移。通常只需要把 SDK 的 baseURL 改成对应接入点的 /v1 地址，并使用 Modelink 控制台中的 API Key 和模型 ID。

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.MODELINK_API_KEY,
  baseURL: process.env.MODELINK_BASE_URL ?? "https://api.qnaigc.com/v1",
});

兼容接口：Anthropic Messages

Anthropic Messages 兼容方式适合 Claude 风格 SDK、Claude Code、长上下文和 Agent 编程工具场景。使用 Anthropic SDK 时，Base URL 通常填写域名本身，不带 /v1。

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: process.env.MODELINK_API_KEY,
  baseURL: process.env.MODELINK_ANTHROPIC_BASE_URL ?? "https://api.qnaigc.com",
});

原厂直通接口（Bypass）

原厂直通接口是在基础兼容协议之外提供的补充能力。与统一协议转换不同，Bypass 模式尽量保留模型提供方的原生协议形态，适合需要使用厂商原生扩展能力的场景。

接入方式协议格式适合场景迁移成本
基础协议OpenAI Chat Completions 或 Anthropic Messages 兼容格式多模型统一接入、已有 OpenAI/Anthropic 风格客户端迁移低
原厂直通各厂商原生协议Extended Thinking、Prompt Caching、联网搜索、Gemini 原生工具、OpenAI Responses 等原生能力中

如果只是做通用对话、代码助手、文本生成或批量任务，通常优先选择基础兼容协议；如果要使用某个模型厂商的原生扩展能力，再评估原厂直通模式。

常用接口路径

以下路径用于帮助你判断 Base URL 和客户端配置方式，不包含请求体 schema 或参数说明。这里的 POST /v1/messages 表示服务端接口路径；Claude Code 等 Anthropic 兼容工具配置 Base URL 时通常填写不带 /v1 的域名，由客户端自行拼接消息接口路径。

接口类型路径协议格式
聊天补全POST /v1/chat/completionsOpenAI Chat Completions 兼容
Anthropic 兼容消息POST /v1/messagesAnthropic Messages 兼容
Anthropic 原厂直通POST /bypass/anthropic/v1/messagesAnthropic Messages API
Vertex / Gemini 原厂直通POST /bypass/vertex/v1/models/{model}:{func}Vertex AI / Gemini API
OpenAI Responses 原厂直通POST /bypass/openai/v1/responsesOpenAI Responses API
模型列表GET /v1/modelsOpenAI 兼容

视频、图像等生成能力使用相同接入点，具体路径、请求参数和返回格式以对应模型或能力文档为准。

接入点选择建议

场景推荐接入点
中国大陆业务https://api.qnaigc.com
海外部署或跨境访问https://api.modelink.ai
高延迟敏感场景在实际部署环境中测试后就近选择
多区域生产部署将 Base URL 配置化，支持按区域切换

接入建议

  • 将 Base URL 配置为环境变量，避免写死在代码中。
  • OpenAI 兼容工具通常使用接入点加 /v1，例如 https://api.qnaigc.com/v1 或 https://api.modelink.ai/v1。
  • Anthropic 兼容工具通常使用不带 /v1 的接入点，例如 https://api.qnaigc.com 或 https://api.modelink.ai。
  • 客户端迁移时优先验证认证方式、模型名称、流式输出、非流式输出和错误处理。
  • 对生产链路设置超时、重试、限流和可观测日志。

下一步

Last updated

© 2026 Modelink. All rights reserved.

构建来自Clarify