Gate.AI 快速入门：使用 Python、Node.js 和 curl 访问 API

Gate.AI 提供了兼容 OpenAI 的 API 接口，开发者可通过 Python、Node.js、curl 及兼容的 AI 开发工具发送聊天补全请求。对于已使用 OpenAI 风格 SDK 或 REST 请求的开发者，接入 Gate.AI API 主要只需更换 API Key 和 Base URL，无需调整请求结构。本文快速入门指南包含一个必要的配置步骤、一次接入路径选择，以及 Python、Node.js、curl 三种互斥实现方式。流式架构、账号权限、生产监控和计费控制等高级主题不在本指南范围内。

前置条件

• 一个 Gate.AI API Key。
• 已安装 Python、Node.js 或 curl（取决于你选择的接入方式）。

完成本指南后你将获得什么能力？

完成本 Gate.AI API 快速入门指南后，你将能够通过所选的 Python、Node.js 或 curl 方式，向 Gate.AI 成功发送聊天补全请求。

你无需完成全部三种语言的示例，只需选择与你应用环境匹配的路径。示例采用 Gate.AI 兼容 OpenAI 的 Base URL 和聊天补全格式，基于 2026年6月的产品版本。如需产品背景，请访问 Gate.AI 产品页面。

步骤1：准备通用 Gate.AI API 配置

本步骤为所有接入路径准备通用 API 配置参数。

操作：

在选择实现路径前，使用以下 Gate.AI API 配置参数。

API Key 用于请求鉴权，Base URL 用于将 OpenAI 兼容 SDK 的调用路由到 Gate.AI。curl 路径需直接使用 Endpoint。

步骤2：选择一种 API 接入路径

本步骤旨在避免 Python、Node.js 与 curl 示例被误认为必须全部执行。

操作：

从下表中选择一种路径。

只需完成一种路径即可验证 Gate.AI API 接入。仅在需要跨多开发环境测试 Gate.AI 时，才需多路径运行。

步骤3A：发送 Python 聊天补全请求

本路径使用 OpenAI Python SDK 并指定 Gate.AI Base URL。

操作：

仅在你的环境为 Python 时使用本路径。

from openai import OpenAI
client = OpenAI(
    api_key="YOUR_GATEAI_API_KEY",
    base_url="https://api.gate.ai/openai/v1",
)
completion = client.chat.completions.create(
    model="auto",
    messages=[
        {"role": "system", "content": "system prompt"},
        {"role": "user", "content": "how are you?"}
    ],
)
print(completion.choices[0].message.content)

你将在终端看到助手回复，例如：

Hello! Nice to meet you. How can I help you?

本路径保持 OpenAI Python SDK 的请求结构，仅更换 API Key 和 Base URL 为 Gate.AI。

步骤3B：发送 Node.js 聊天补全请求

本路径使用 OpenAI Node.js SDK 并指定 Gate.AI Base URL。

操作：

仅在你的环境为 Node.js 时使用本路径。

const OpenAI = require("openai")
const client = new OpenAI({
    apiKey: "YOUR_GATEAI_API_KEY",
    baseURL: "https://api.gate.ai/openai/v1",
})
async function main() {
    const completion = await client.chat.completions.create({
        model: "auto",
        messages: [
            {"role": "system", "content": "system prompt"},
            {"role": "user", "content": "how are you?"}
        ],
    })
    console.log(completion.choices[0].message.content)
}
main()

你将在控制台看到助手回复。如果脚本运行无输出，请打印完整 completion 对象，确认 choices[0].message.content 字段存在。

步骤3C：发送 curl 聊天补全请求

本路径无需 SDK，直接调用 Gate.AI 聊天补全接口。

操作：

仅在你需要通过终端直接发起 REST 请求时使用本路径。

curl --location --request POST 'https://api.gate.ai/openai/v1/chat/completions' \
--header 'Authorization: Bearer YOUR_GATEAI_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "deepseek/deepseek-v3.2",
    "stream": false,
    "messages": [
        {
            "role": "user",
            "content": "how are you"
        }
    ]
}'

你将收到包含 choices 数组的 JSON 响应。助手回复位于 choices[0].message.content 字段。

Gate.AI API 成功响应示例

成功的 Gate.AI 聊天补全响应遵循 OpenAI 兼容的结构。

{
    "id": "243c850e-214c-431e-977f-ebaf4aa95f56",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "Hello! Nice to meet you. How can I help you?"
            },
            "finish_reason": "stop"
        }
    ],
    "created": 1773408946,
    "model": "deepseek.v3-v1:0",
    "object": "chat.completion",
    "usage": {
        "prompt_tokens": 5,
        "completion_tokens": 15,
        "total_tokens": 20
    }
}

快速测试时，最关键字段为 choices[0].message.content。usage 对象可帮助确认 Gate.AI 已处理提示词与回复内容。

Gate.AI API 请求失败常见原因与排查

• 症状：请求返回鉴权错误。
  • 原因：API Key 缺失、过期、格式错误或未正确从 Gate.AI 复制。
  • 解决：将 YOUR_GATEAI_API_KEY 替换为有效的 Gate.AI API Key。对于 curl，保持 Authorization: Bearer YOUR_GATEAI_API_KEY 头部格式。
• 症状：SDK 请求发送到错误服务。
  • 原因：OpenAI SDK 仍使用默认 Base URL。
  • 解决：在 Python 设置 base_url，Node.js 设置 baseURL 为 https://api.gate.ai/openai/v1 后再发送请求。
• 症状：响应未使用预期模型。
  • 原因：请求使用 auto，或 Gate.AI 在自动模型选择时映射了不同模型 ID。
• 症状：脚本运行但无输出。
  • 原因：代码未读取 completion.choices[0].message.content，或请求在打印前已失败。

下一步可配置或集成内容

完成任一 Gate.AI 快速入门 API 路径后，可将同一 Gate.AI Base URL 集成到你的应用后端、开发工具、内部自动化或测试流程中。

推荐后续主题：

• 了解 Gate.AI 在 AI 开发流程中的应用，请参阅 Gate.AI 产品概览。
• 查阅 Gate.AI API 文档，获取支持的 API 行为、模型详情与实现参考。

常见问题解答

我需要同时运行 Python、Node.js 和 curl 吗？

不需要。根据你的开发环境选择其中一种接入路径即可。Python、Node.js 和 curl 只是发送 Gate.AI 聊天补全请求的不同方式。

为什么 Python 用 base_url，Node.js 用 baseURL？

Python SDK 使用下划线命名（snake_case），Node.js SDK 使用驼峰命名（camelCase）。两者均指向同一个 Gate.AI Base URL。

每次请求都能用 model="auto" 吗？

当你希望 Gate.AI 自动选择模型且你的配置支持时，可用 auto。如需指定模型，请参考 Gate.AI 文档选用支持的模型 ID。

JSON 输出中的助手回复在哪？

助手回复位于 choices[0].message.content 字段。Token 使用情况在 usage 对象中单独展示。