快速开始 - OmniMux

本指南带你完成：创建 API Key → 配置 Base URL → 发送请求。

前置条件

可访问 OmniMux 控制台
账户有可用额度（或管理员已分配令牌）

步骤

创建 API Key

登录控制台，打开 令牌 / API Keys，创建新密钥。密钥形如 sk-...。只在服务端或私密环境变量中保存，不要写入前端或公开仓库。

确认 Base URL

网关 Base URL（API 专用域名）：

https://api.geminix.cc

使用 OpenAI 兼容 SDK 时，一般填：

https://api.geminix.cc/v1

SDK 会再拼 /chat/completions 等路径。控制台在 geminix.cc/dashboard，与 API 域名分开。

发送第一条请求

使用 curl：

curl https://api.geminix.cc/v1/chat/completions \
  -H "Authorization: Bearer $OMNIMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "你好，用一句话介绍你自己"}
    ]
  }'

model 必须是你账户可用的模型名。可在控制台查看，或调用 GET /v1/models。详见模型列表。

使用官方 OpenAI SDK

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-...",  # OmniMux token
    base_url="https://api.geminix.cc/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(resp.choices[0].message.content);

下一步

主题	说明
配置 Base URL	客户端 / SDK 填法
鉴权	Header 格式与安全注意
模型	如何枚举与选择 model
API 参考	Chat、Claude、Gemini、图像、视频等完整接口

API Key 可消费账户额度。仅放在服务端；泄露后立即在控制台吊销并轮换。

OmniMux 文档鉴权

⌘I

​前置条件

​步骤

​使用官方 OpenAI SDK

​Python

​Node.js

​下一步

前置条件

步骤

使用官方 OpenAI SDK

Python

Node.js

下一步