从注册到可用配置，一页完成 Gateways 接入

为什么接入 AI 编程助手

令牌创建截图步骤

提交后会自动生成密钥，也就是 API Key，格式为 sk-xxxxxxxxx。令牌是访问 API 的凭证，请妥善保管，不要泄露。

前置条件

# Ubuntu / Debian
sudo apt-get update && sudo apt-get install -y git

# CentOS / RHEL
sudo yum install -y git

# fnm
curl -fsSL https://fnm.vercel.app/install | bash
fnm install --lts
node -v

Windows 使用 fnm 安装 Node.js

原文档推荐 fnm：版本切换方便、升级无痛、不污染系统环境。Windows 可下载 fnm-windows.zip，将 fnm.exe 解压到固定目录，例如 C:\fnm，再把该目录加入用户 Path。

fnm install --lts
node -v

安装 Claude Code

npm install -g @anthropic-ai/claude-code

Linux 如遇权限问题可使用：

sudo npm install -g @anthropic-ai/claude-code

安装完成后运行 claude --version 验证，然后在终端输入 claude 打开。

启动与 IDE 使用

CC-Switch 图形配置

CC-Switch 支持一键切换 API 配置、可视化配置管理、MCP 服务器管理和系统托盘快捷操作。Windows 用户可下载 .msi 安装包。

npm install -g @openai/codex
export OPENAI_API_KEY="sk-你的令牌"
export OPENAI_BASE_URL="https://api.qygate.com/v1"

npm install -g @google/gemini-cli
export GEMINI_API_KEY="sk-你的令牌"
export GEMINI_BASE_URL="https://api.qygate.com/"

OpenCode 图形配置步骤

# Windows
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

# macOS / Linux
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Cherry Studio 截图流程

Hermes Agent 配置细节

Windows 如提示未安装 uv，可先安装 uv，再重新运行 Hermes 安装命令。配置时选择快速配置，提供方选择 custom endpoint，URL 需要填写为站点地址加 /v1。

# Windows uv 备选安装方式
pip install uv
winget install astral-sh.uv

Windows 可按 Win + R 输入 %LOCALAPPDATA%\hermes 打开配置目录修改 config 文件，或在 PowerShell 中输入 hermes setup 重新配置。

curl https://api.qygate.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的Token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只橘猫坐在沙发上",
    "size": "3840x2160"
  }'

curl "https://api.qygate.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
  -H "Authorization: Bearer sk-你的Token" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{ "text": "生成一张 16:9 的写实产品图" }]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": { "aspectRatio": "16:9", "imageSize": "2K" }
    }
  }'

GPT-Image-2 SDK 示例

from openai import OpenAI
import base64

client = OpenAI(
    api_key="sk-你的Token",
    base_url="https://api.qygate.com/v1",
)

res = client.images.generate(
    model="gpt-image-2",
    prompt="一只橘猫坐在沙发上",
    size="3840x2160",
)

with open("cat.png", "wb") as f:
    f.write(base64.b64decode(res.data[0].b64_json))

import OpenAI from "openai";
import fs from "fs";

const client = new OpenAI({
  apiKey: "sk-你的Token",
  baseURL: "https://api.qygate.com/v1",
});

const res = await client.images.generate({
  model: "gpt-image-2",
  prompt: "一只橘猫坐在沙发上",
  size: "3840x2160",
});

fs.writeFileSync(
  "cat.png",
  Buffer.from(res.data[0].b64_json, "base64"),
);

GPT-Image-2 图生图 / 多参考图

可在 /v1/images/generations 请求中通过 image 传入参考图。建议使用 Data URL，例如 data:image/png;base64,...。多张参考图时 image 可以传数组。

curl https://api.qygate.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的Token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "参考这张图，保持主体和构图，改成高端电商海报风格，背景为浅灰影棚",
    "image": "data:image/png;base64,BASE64_IMAGE_DATA",
    "size": "2048x2048"
  }'

图形客户端适配

Banana 2/Pro 4K 与参考图示例

curl "https://api.qygate.com/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "Authorization: Bearer sk-你的Token" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{ "text": "画一张电影海报风格的未来城市夜景，主体是一辆红色概念跑车" }]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": { "aspectRatio": "9:16", "imageSize": "4K" }
    }
  }'

Gemini 原生格式通过 inlineData 传入参考图，data 只放 base64 内容，不要带 data:image/png;base64, 前缀。

{
  "contents": [{
    "role": "user",
    "parts": [
      { "text": "参考这张图，保持主体不变，改成清晨阳光下的水彩插画风格" },
      {
        "inlineData": {
          "mimeType": "image/png",
          "data": "BASE64_IMAGE_DATA"
        }
      }
    ]
  }],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": { "aspectRatio": "1:1", "imageSize": "2K" }
  }
}

OpenAI 兼容聊天接口调用 Banana

curl "https://api.qygate.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-你的Token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "messages": [{
      "role": "user",
      "content": "生成一张 16:9 的赛博朋克街景，霓虹灯，雨夜，电影感"
    }],
    "extra_body": {
      "google": {
        "image_config": {
          "aspect_ratio": "16:9",
          "image_size": "2K"
        }
      }
    }
  }'

参数与错误速查

请求参数与响应格式