OpenAI API 国内接入 · 从第一条请求开始

OpenAI API 国内接入：Base URL、Key 与首次请求一次配置

如果现有代码已经使用 OpenAI SDK，迁移到 LinkAGI 通常只需要替换 Base URL 与 API Key。真正容易出错的不是代码主体，而是地址层级、模型名和密钥分组。

直接开始排查查看实时模型

更新：2026-07-23 · 先用短请求验证，再迁移正式任务。

先把三个关键变量分开

同一个错误可能由不同层级触发。按地址、认证、模型或并发逐层验证，比同时修改所有配置更容易定位原因。

Base URL

填写 https://api.linktoagi.com/v1，不要直接填完整的 /chat/completions 或 /responses。

API Key

从 LinkAGI 控制台创建 sk- 开头的项目 Key，不使用 ChatGPT 账号或密码。

模型名

从实时模型广场复制当前可用名称，不凭旧教程猜写。

三步完成最小验证

保留一个可复现的短请求，每次只修改一个变量，并记录返回状态。

先创建独立 Key

登录控制台，在令牌管理中为测试项目创建单独的 API Key。

替换 SDK 地址

保留原有 SDK 调用方式，只把 base_url 改为 LinkAGI 的 /v1 地址。

发送短请求

使用一句短提示验证认证、模型和协议，成功后到日志核对 Token 与扣费。

Python SDK 最小验证示例

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["LINKAGI_API_KEY"],
    base_url="https://api.linktoagi.com/v1",
)

response = client.responses.create(
    model="从控制台复制当前模型名",
    input="回复 OK，用于第一次连通性测试",
)
print(response.output_text)

API Key 只放在环境变量或客户端密钥字段中，不要写进公开仓库、截图或前端代码。模型名与价格请从 LinkAGI 实时模型广场复制。