UniKeyX UniKeyX API Docs

OpenAI-compatible endpoint

使用 www.unikeyx.com 调用 MAI、GPT 与 Claude 模型

所有示例默认使用统一入口 https://www.unikeyx.com/v1。 你只需要在控制台创建令牌，把示例里的 YOUR_UNIKEYX_API_KEY 替换成自己的 API Key。

开始接入 查看示例

Quick start

三步完成接入

2

创建 API Key

在令牌页面创建一个新的 Key。妥善保存，后续示例都使用它作为 Bearer Token。

3

替换 Base URL

把 OpenAI SDK 或兼容客户端的 base_url 改成 https://www.unikeyx.com/v1。

模型名提示

示例使用常用模型名。若控制台模型列表显示了不同别名，请以控制台可见模型名为准。

Copy-ready samples

通用 SDK 初始化

Python 
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_UNIKEYX_API_KEY",
    base_url="https://www.unikeyx.com/v1",
)
JavaScript 
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.UNIKEYX_API_KEY,
  baseURL: "https://www.unikeyx.com/v1",
});

Image generation

MAI 生图与 GPT 生图

MAI MAI-Image-2

MAI 生图：生成商品海报

适合中文提示词、运营物料、商品图和海报草图。返回结果通常包含图片 URL 或 base64，取决于上游返回格式和通道配置。

curl 
curl https://www.unikeyx.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_UNIKEYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MAI-Image-2",
    "prompt": "一张高端咖啡豆礼盒的中文电商主图，白色背景，柔和棚拍光，真实产品摄影风格",
    "size": "1024x1024",
    "quality": "high",
    "n": 1
  }'
GPT Image gpt-image-2

GPT 生图：生成插画视觉

适合需要严格遵循英文或中英文混合提示词的场景。若你的控制台只开放了 gpt-image-1，把模型名替换即可。

Python 
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_UNIKEYX_API_KEY",
    base_url="https://www.unikeyx.com/v1",
)

image = client.images.generate(
    model="gpt-image-2",
    prompt="A clean editorial illustration of a small AI API gateway, with clear labels and modern product UI details.",
    size="1024x1024",
    quality="high",
    n=1,
)

print(image.data[0].url or image.data[0].b64_json)

Chat completion

GPT-5.6 与 Claude Sonnet 5 调用

GPT gpt-5.6

GPT-5.6：结构化摘要

用于复杂推理、长文本整理和高质量中文输出。示例使用 Chat Completions 兼容格式。

JavaScript 
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.UNIKEYX_API_KEY,
  baseURL: "https://www.unikeyx.com/v1",
});

const completion = await client.chat.completions.create({
  model: "gpt-5.6",
  messages: [
    { role: "system", content: "你是一个严谨的中文技术文档助手。" },
    {
      role: "user",
      content: "把 UniKeyX 的 API 接入流程总结成 3 个步骤，并给出注意事项。",
    },
  ],
  temperature: 0.3,
});

console.log(completion.choices[0].message.content);
Claude claude-sonnet-5

Claude Sonnet 5：审阅与改写

用于文档审阅、代码解释、客服回复和风格化改写。通过 UniKeyX 仍使用同一个 OpenAI-compatible 入口。

curl 
curl https://www.unikeyx.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_UNIKEYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [
      {
        "role": "system",
        "content": "你是一个负责审阅 API 文档的资深工程师。"
      },
      {
        "role": "user",
        "content": "请把这段说明改写得更清晰：先创建令牌，然后把 base_url 改为 UniKeyX。"
      }
    ],
    "temperature": 0.2
  }'

Troubleshooting

常见问题

401 unauthorized

检查 API Key 是否复制完整，Header 是否为 Authorization: Bearer YOUR_UNIKEYX_API_KEY。

模型不存在或无权限

打开控制台确认当前令牌所属分组是否允许使用该模型。必要时把示例模型名替换为控制台显示的模型名。

图片返回 base64 而不是 URL

不同上游和通道配置可能返回不同图片字段。客户端建议同时兼容 url 和 b64_json。

OpenAI SDK 报 baseURL 或 base_url 错误

Python SDK 使用 base_url，JavaScript SDK 使用 baseURL。

References

参考文档