← GGD AI Gateway获取 API Key

接入文档

GGD AI Gateway 完全兼容 OpenAI API 协议。把 Base URL 指向本平台，把 API Key 换成平台 Key，即可在任意 OpenAI 兼容工具中使用。

快速开始

  1. 注册并登录 用户控制台
  2. 在「API Key」页面创建一个 Key（完整 Key 仅展示一次，请妥善保存）
  3. 把下面两个环境变量配置到你的工具中即可
OPENAI_BASE_URL=https://api.ggd.cc/v1
OPENAI_API_KEY=sk-ggd-你的密钥

获取 API Key

进入控制台 → API Key → 新建。可为每个 Key 单独设置限速（RPM）、每日额度、启用/禁用。Key 仅在创建时显示完整内容，之后只显示前后几位。

Base URL

Base URL:  https://api.ggd.cc/v1
Chat:      POST https://api.ggd.cc/v1/chat/completions
Models:    GET  https://api.ggd.cc/v1/models
Embedding: POST https://api.ggd.cc/v1/embeddings

curl 示例

# 列出模型
curl https://api.ggd.cc/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

# 对话补全
curl https://api.ggd.cc/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [{"role":"user","content":"你好，介绍一下你自己"}]
  }'

把 model 设为 auto 即开启智能路由，平台会根据任务自动选择最优模型。

JavaScript / Node（openai SDK）

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.ggd.cc/v1",
  apiKey: process.env.OPENAI_API_KEY,
});

const res = await client.chat.completions.create({
  model: "auto",
  messages: [{ role: "user", content: "用一句话介绍 GGD AI Gateway" }],
});
console.log(res.choices[0].message.content);

Python（openai SDK）

from openai import OpenAI

client = OpenAI(
    base_url="https://api.ggd.cc/v1",
    api_key="sk-ggd-你的密钥",
)

resp = client.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Dify 接入

在 Dify「模型供应商」中选择 OpenAI-API-compatible，填写：

API Base:  https://api.ggd.cc/v1
API Key:   sk-ggd-你的密钥
模型名称:   auto 或具体模型（如 mock-echo / 后续的 gpt-4o、deepseek-chat）

Cherry Studio 接入

设置 → 模型服务 → 添加 → OpenAI
API 地址(Host): https://api.ggd.cc
API 路径:        /v1
API 密钥:        sk-ggd-你的密钥
添加模型:        auto / mock-echo

Open WebUI 接入

设置 → 连接 → OpenAI API
API Base URL: https://api.ggd.cc/v1
API Key:      sk-ggd-你的密钥

NextChat / LobeChat / LangChain / Ragflow / Cursor 等工具同理：凡支持自定义 OpenAI Base URL 的客户端均可接入。

错误码说明

HTTPtype含义
401auth_errorAPI Key 缺失或无效
403key_disabled / user_disabledKey 或账号被禁用 / 风控
402insufficient_balance余额不足，请充值
429rate_limit / quota_exceeded触发限速或每日额度上限
503no_model无可用模型，请联系管理员配置 Provider
502upstream_error上游 Provider 返回错误
501not_implemented该接口为预留接口（如图片/音频）

计费说明