OpenAI-Compatible API

云镜 API 文档

使用一个统一的 API Key 接入 GPT、Claude、Gemini 以及后续开放的图像/视频模型。云镜 API 默认兼容 OpenAI 请求结构，方便直接接入 Claude Code、Codex、Cherry Studio、Open WebUI 或自建应用。

创建 API Key 查看模型价格

Production Endpoint v1

Base URLhttps://api.myaigc.shop/v1

鉴权Bearer API Key

响应格式OpenAI Compatible

主要能力Text / Image / Model List

https://api.myaigc.shop/v1

快速开始

先创建令牌，再把 Base URL 和 API Key 填到客户端或自己的应用里。

1. 创建密钥

登录控制台，进入 令牌管理，创建一个新的 API Key。

2. 配置客户端

Base URL 填 https://api.myaigc.shop/v1，Key 填你的令牌。

3. 发送请求

按 OpenAI 兼容格式请求 /chat/completions 或其他开放接口。

认证方式

所有模型调用都需要在请求头中携带用户自己的 API Key。

HTTP Headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

不要把 API Key 写进前端公开代码、公开仓库、浏览器插件配置截图或群聊截图。密钥泄露后请立即在控制台禁用并重新创建。

代码示例

下面示例都使用同一个 Base URL，只需要替换自己的 API Key 和模型名称。

chat.completions

curl https://api.myaigc.shop/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1-mini",
    "messages": [
      {"role": "user", "content": "你好，介绍一下云镜 API"}
    ],
    "temperature": 0.7
  }'

Node.js fetch

const response = await fetch("https://api.myaigc.shop/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "gpt-4.1-mini",
    messages: [{ role: "user", content: "你好，介绍一下云镜 API" }]
  })
});

const data = await response.json();
console.log(data.choices[0].message.content);

Python requests

import requests

response = requests.post(
    "https://api.myaigc.shop/v1/chat/completions",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "gpt-4.1-mini",
        "messages": [{"role": "user", "content": "你好，介绍一下云镜 API"}],
    },
)

print(response.json()["choices"][0]["message"]["content"])

接口列表

当前保留常用 OpenAI 兼容接口；模型是否可用取决于后台开放的渠道和模型。

方法	Endpoint	用途	说明
POST	/v1/chat/completions	文本对话	最常用接口，适合 GPT、Claude 兼容调用和普通聊天补全。
POST	/v1/responses	Responses API	用于兼容新版 OpenAI Responses 结构，实际可用性看上游渠道。
POST	/v1/messages	Claude Messages	用于 Claude Messages 兼容调用，适合支持 Anthropic 格式的客户端。
POST	/v1/images/generations	图像生成	用于图片生成模型，按次或按任务计费。
GET	/v1/models	模型列表	返回当前 API Key 可见的模型列表。

模型与价格

模型价格需要登录后查看。价格页会以“100 万 tokens 大概多少钱”的方式展示。

打开模型价格

ChatGPT

适合通用对话、写作、代码、自动化工作流。

Claude

适合长文本、代码理解、复杂任务拆解。

Gemini / 图像 / 视频

后续按实际渠道开放，先保证核心文本模型稳定。

常见错误

客户端接入失败时，优先检查状态码、鉴权头、模型名称和余额。

状态码	常见原因	处理方式
`401`	未携带 API Key、Key 填错或密钥已禁用。	检查 `Authorization: Bearer ...`，重新复制控制台密钥。
`403`	账户、分组或模型权限不允许。	确认账号状态、可用分组和令牌可用模型限制。
`429`	请求过快或额度不足。	降低并发，检查余额和令牌额度。
`500 / 502`	上游渠道异常或模型暂时不可用。	稍后重试，必要时联系管理员切换渠道。

客户端配置

大多数支持 OpenAI Base URL 的客户端都可以接入。

客户端	Base URL	API Key	模型
Claude Code / Codex	`https://api.myaigc.shop/v1`	控制台令牌	选择已开放模型
Cherry Studio	`https://api.myaigc.shop/v1`	控制台令牌	从模型列表填入
Open WebUI / LobeChat	`https://api.myaigc.shop/v1`	控制台令牌	从 `/v1/models` 同步
自建网站 / App	`https://api.myaigc.shop/v1`	后端保存	按业务选择

接入建议

把调用链路做稳，比堆很多模型更重要。

✓

不要暴露密钥
生产应用应把 API Key 放在后端，不要直接放到浏览器端。

✓

设置合理超时
建议客户端设置 60-120 秒超时，并对上游失败做重试。

✓

记录请求 ID
出现问题时保留时间、模型、状态码和返回信息，方便排查。

✓

先跑核心模型
先稳定 GPT、Claude、Gemini，再扩展图片和视频模型。