多模态 AI Gateway

支持 Gemini（Google Gen AI SDK，请求路径含 /v1beta）与 OpenAI / DeepSeek（OpenAI SDK，baseURL 含 /v1）。SDK 的 baseUrl 填 https://<host>/g/<public-id>（勿含 /v1beta）。请求体中的 model 与官方 SDK 用法相同，由网关端点结合控制台逻辑路由与模型连接解析转发。

平台 API Key

请求须携带控制台创建的平台 API Key（非上游 Gemini/OpenAI Key），并通过 x-goog-api-key（Gemini）或 Authorization: Bearer（OpenAI）传递。密钥须属于该 Gateway 所在团队；创建时若绑定了 Gateway，则只能访问该 Gateway 的 /g/<public-id>/...。未绑定的密钥可访问同团队内任意 Gateway（URL 中的 public-id 仍须正确）。建议在 API 密钥页面绑定目标 Gateway。

在 API 密钥创建；在 Gateway 详情配置上游提供商 Key（模型连接）。

准备

Public ID：Gateway 详情页「访问端点」中 /g/ 后的 10 位短码；见 Gateway（需配置上游 API Key）
平台 API Key：见 API 密钥（建议绑定目标 Gateway）
逻辑路由与模型连接：在 Gateway 控制台配置；网关根据请求中的 model 与已启用路由在端点侧处理（保存时同一 Gateway 仅一条路由为启用）

baseUrl = "https://saas.artalaxies.com/g/<public-id>"   # 不要加 /v1beta

访问协议

在 Gateway 详情「访问协议」中勾选客户端入口；未启用的协议请求返回 403。默认启用全部内置协议。

协议 id	路径（相对 /g/<public-id>/）	客户端
gemini-v1beta	v1beta/**	Google Gen AI SDK（baseUrl 不含 /v1beta）
openai-chat	v1/chat/completions	OpenAI SDK · Chat Completions（baseURL 含 /v1）
openai-responses	v1/responses	OpenAI SDK · Responses API

Gemini SDK 还会使用 /upload/v1beta/... 上传；当前实现不单独做协议开关（与 Gemini 共用 baseUrl）。

JavaScript（@google/genai）

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({
  apiKey: process.env.INFRANEST_API_KEY!,
  httpOptions: {
    baseUrl: "https://saas.artalaxies.com/g/<public-id>",
  },
});

// model 由请求传入，与官方 SDK 一致
await ai.models.generateContent({
  model: "your-model",
  contents: "Hello",
});

Python（google-genai）

import os
from google import genai

client = genai.Client(
    api_key=os.environ["INFRANEST_API_KEY"],
    http_options={"base_url": "https://saas.artalaxies.com/g/<public-id>"},
)

# model 由请求传入，与官方 SDK 一致
client.models.generate_content(model="your-model", contents="Hello")

OpenAI / DeepSeek

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.INFRANEST_API_KEY!,
  baseURL: "https://saas.artalaxies.com/g/<public-id>/v1",
});

await client.chat.completions.create({
  model: "your-model",  // model 由请求传入
  messages: [{ role: "user", content: "Hello" }],
});

须启用 openai-chat。Gateway 在控制台配置模型连接，支持 Gemini、OpenAI、DeepSeek 等多节点。

curl 示例（Gemini generateContent）

将 YOUR_PLATFORM_KEY 与 public-id 替换为控制台中的实际值。

curl "https://saas.artalaxies.com/g/<public-id>/v1beta/models/your-model:generateContent" \
  -H "x-goog-api-key: YOUR_PLATFORM_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"Hello"}]}]}'

常见错误

HTTP	常见原因
401	平台 API Key 无效或未传（Gemini：x-goog-api-key；OpenAI：Authorization）
403	访问协议未启用（如 gemini-v1beta、openai-chat）
404	public_id 无效或 Gateway 未启用
503	Gateway 未配置上游 API Key（模型连接）

配置逻辑路由

在控制台设置逻辑路由、模型连接、IF/ELSE 条件（输入格式或 Header/元数据）、回退链、prompt 模板与温度/JSON/向量维度等。客户端照常通过 SDK 在请求中传入 model，由网关端点解析。

→ 逻辑路由说明（含画布示例）→ 控制台