1. 多模型聚合调度 (核心优势)

得益于我们强大的中转分发层架构，您仅需一个 API Key 和统一的 Base URL，即可直接调用全网各大顶尖模型（如 GPT-4o, Claude 3.5, 高级图像模型等），而无需再去各个官方平台分别注册和充值。

调用不同模型时，您无需修改任何鉴权逻辑，只需在 JSON 请求体中更改 model 参数即可：

• 语言对话类模型： 例如 gpt-4o、claude-3-5-sonnet-20240620。
• 图像生成模型： 例如 gpt-image-2（详细参数参考侧边栏的专属文档）。

2. API 鉴权机制 (Authentication)

每一次向服务器发起的 HTTP 请求，都必须在请求头 (Header) 中包含您的私有令牌。

请按照如下格式在 Header 中添加 Authorization 字段，并在您的 API Key 前加上 Bearer 前缀（注意包含一个空格）：

Authorization: Bearer sk-Your_API_Key_Here

3. 通用接口约定

4. 错误代码与额度管理

当请求失败时，系统会返回标准 HTTP 状态码，并在 JSON 响应体中包含详细的错误提示。

1. 基础信息与鉴权配置

所有接口调用均需要使用 HTTPS 请求。通过 HTTP Header 传入您的访问令牌（API Key）进行身份验证。

2. 文字生图 (Text-to-Image)

根据用户提供的纯文本描述，在服务器端生成全新的图像。

请求参数 (Request Body)

代码调用示例 (cURL)

curl -X POST https://ai.yuanc.icu/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your_api_key_here" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只赛博朋克风格的机械猫，背景是霓虹闪烁的未来城市，高质量",
    "size": "16:9",
    "quality": "standard",
    "n": 1,
    "response_format": "url"
  }'

响应示例 (JSON)

{
  "created": 1726640821,
  "data": [
    {
      "url": "https://disk.aipais.de/2026/09/19/sample_image.jpg"
    }
  ],
  "usage": {
    "total_tokens": 16384
  }
}

3. 图生图与图像重绘 (Image-to-Image / Edits)

提供基于源图像的参考生成与深度重绘功能。本系统采用了业界独家的“双轨处理机制”，请参考下方最佳实践选择最适合您的接入方式：

请求参数 (Form Data)

代码调用示例 (cURL)

curl -X POST https://ai.yuanc.icu/v1/images/edits \
  -H "Authorization: Bearer sk-your_api_key_here" \
  -F "image=@/path/to/your/local_image.png" \
  -F "prompt=将人物的衣服颜色修改为金黄色" \
  -F "model=gpt-image-2" \
  -F "size=16:9" \
  -F "quality=standard"

4. 高级研发须知

5. Gemini 专属生图通道 (Multimodal Generation)

得益于 Gemini 强大的原生多模态能力，当您调用 Gemini 专属的生图模型时，无需使用 /images/generations 接口，而是直接通过标准的对话接口（/v1/chat/completions）发送绘图指令。系统将在助手的回复中直接以 Markdown 格式内嵌 Base64 图像返回。

代码调用示例 (cURL)

curl -X POST https://ai.yuanc.icu/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your_api_key_here" \
  -d '{
    "model": "gemini-3.1-flash-image",
    "messages": [
      {
        "role": "user",
        "content": "画一只戴着墨镜的猫，在沙滩上晒太阳，4k高清"
      }
    ]
  }'

响应示例 (Markdown Base64)

6. Gemini / 香蕉Pro 原生高级画幅控制 (自然语言构图)

许多开发者习惯于在生图 API 中寻找专门的 size 参数按钮，或使用 Midjourney 专属的 --ar 16:9 指令。但请注意，Gemini 官方模型（基于 Imagen 3 底层）内置了更强大的多模态原生构图理解能力！

您完全不需要在 API 参数中传递特殊字段，或者在尾部添加代码指令。只需在您的提示词（Prompt）中使用自然语言描述您期望的画幅或构图，底层的扩散引擎就会自动识别并输出原生高清固定比例。

实测支持的自然语言比例与实际像素输出

如何在 Prompt 中精准控制？

注：无需像 Midjourney 那样加 --ar 16:9 等外部控制标志，直接用人类语言描述比例，Gemini 将准确无误地输出对应尺寸。