银河杂货铺 · API 指南

银河杂货铺 · AI 中转服务

一套 OpenAI 兼容接口覆盖 OpenAI、Anthropic、DeepSeek、Gemini、即梦等主流模型。

快速开始

Base URL

https://api.glmbigmodel.me

支持Codex, Claude Code, Cherry Studio, Cline, Kilo Code, Roo Code, Open Code, Crush, Goose, iflow Cli等主流软件

网络策略

内置重试 + 熔断

中转站会对 429/5xx 进行重试,最终错误会透传上游厂商。

SDK

OpenAI/Anthropic/Gemini 兼容

推荐直接使用官方 OpenAI/Anthropic/Gemini SDK,将 `baseURL` 指向银河中转即可。

绘图模型介绍

主要介绍一些绘图模型的调用方法

✅ 建议先使用curl等工具进行测试,若某一线路连通性不佳,可换另一条线路试试。
模型 调用方法 参数适配 注意事项
nanobanana

OpenAI Image

OpenAI Chat

不支持设置大小,宽高等
参数
逆向模型,支持文生图/图生图
jimeng-4.0
jimeng-4.1
jimeng-4.5

OpenAI Image

Ratio: 21:9, 16:9, 3:2, 4:3,
1:1, 3:4, 2:3, 9:16
分辨率: 1k/2k
支持文生图/图生图
grok-imagine-1.0
grok-imagine-1.0-edit

OpenAI Image

OpenAI Chat

Ratio: 16:9,9:16,1:1,2:3,3:2 分别支持文生图和图生图
gemini-3-pro-
image-preview
(Nano Banana Pro)

Gemini Image

aspectRatio: 21:9, 16:9, 3:2,
4:3, 1:1, 3:4, 2:3, 9:16
分辨率: 1k/2k/4k
上游对接 GCP,支持文生图/图生图

Chat 接口

给定一组包含对话的消息列表,模型将返回一个响应。相关指南可参阅OpenAI官网

OpenAI · Chat Completions

POST /v1/chat/completions

完整兼容 OpenAI Chat 接口,支持流式、工具调用、JSON Mode。推荐直接复用官方 SDK,只需覆写 `baseURL` 与密钥。

  • 支持 `stream`、`response_format`、`parallel_tool_calls`
curl --request POST \
  --url https://api.glmbigmodel.me/v1/chat/completions \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "You are a helpful AI assistant."},
      {"role": "user", "content": "列出银河杂货铺提供的能力"}
    ],
    "temperature": 0.7,
    "stream": false
  }'
{
  "id": "chatcmpl-92b5",
  "object": "chat.completion",
  "created": 1763036400,
  "model": "gpt-4o-mini",
  "choices": [
    {
      "index": 0,
      "message": {"role": "assistant", "content": "..." },
      "finish_reason": "stop"
    }
  ],
  "usage": {"prompt_tokens": 56, "completion_tokens": 128, "total_tokens": 184},
}

OpenAI · Responses

POST /v1/responses 多模态输入

OpenAI 最先进的模型响应接口。支持文本和图像输入,以及文本输出。创建与模型的有状态交互,将先前响应的输出用作输入。通过文件搜索、网络搜索、计算机使用等内置工具扩展模型的能力。使用函数调用允许模型访问外部系统和数据。 相关指南可参阅OpenAI官网

curl --request POST \
  --url https://api.glmbigmodel.me/v1/responses \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "o3-mini",
    "input": "一只啄木鸟能啄多少木头?",
    "reasoning": {
      "effort": "high"
    }
  }'
{
  "id": "resp_67ccd7eca01881908ff0b5146584e408072912b2993db808",
  "object": "response",
  "created_at": 1741477868,
  "status": "completed",
  "error": null,
  "incomplete_details": null,
  "instructions": null,
  "max_output_tokens": null,
  "model": "o1-2024-12-17",
  "output": [
    {
      "type": "message",
      "id": "msg_67ccd7f7b5848190a6f3e95d809f6b44072912b2993db808",
      "status": "completed",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "这是一个源自英文绕口令"How much wood would a woodchuck chuck if a woodchuck could chuck wood"的问题。在现实中,啄木鸟(woodpecker)和土拨鼠(woodchuck)是不同的动物,而且土拨鼠实际上并不"啄(chuck)"木头。\n\n从科学角度看,啄木鸟每天确实会啄树木以寻找食物、建造巢穴或进行通讯。一只啄木鸟平均每天可能啄树约8000-12000次,视物种和具体目的而定。如果我们将这转换为木材量,假设每次啄击移除约0.1-0.2立方厘米的木材,那么一只啄木鸟理论上每天可能移除约800-2400立方厘米的木材。\n\n然而,啄木鸟主要是为了觅食和筑巢而啄木,而不是单纯地移除木材,所以这个计算只是一个有趣的理论估算。",
          "annotations": []
        }
      ]
    }
  ],
  "parallel_tool_calls": true,
  "previous_response_id": null,
  "reasoning": {
    "effort": "high",
    "summary": null
  },
  "store": true,
  "temperature": 1.0,
  "text": {
    "format": {
      "type": "text"
    }
  },
  "tool_choice": "auto",
  "tools": [],
  "top_p": 1.0,
  "truncation": "disabled",
  "usage": {
    "input_tokens": 81,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 1035,
    "output_tokens_details": {
      "reasoning_tokens": 832
    },
    "total_tokens": 1116
  },
  "user": null,
  "metadata": {}
}

Anthropic · Messages

POST /v1/anthropic/messages anthropic-version: 2023-06-01

给定一组包含文本和/或图像内容的结构化输入消息列表,模型将生成对话中的下一条消息。Messages API 可用于单次查询或无状态的多轮对话。

curl --request POST \
  --url https://api.glmbigmodel.me/v1/anthropic/messages \
  --header "x-api-key: $NEWAPI_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "claude-3-5-sonnet-20241022",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Hello, world"}
    ]
}'
{
  "content": [
    {
      "text": "Hi! My name is Claude.",
      "type": "text"
    }
  ],
  "id": "msg_013Zva2CMHLNnXjNJKqJ2EF",
  "model": "claude-3-5-sonnet-20241022", 
  "role": "assistant",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "type": "message",
  "usage": {
    "input_tokens": 2095,
    "output_tokens": 503
  }
}

DeepSeek · Reasoning Content

POST /v1/chat/completions reasoning_content

Deepseek-reasoner 是 DeepSeek 推出的推理模型。在输出最终回答之前,模型会先输出一段思维链内容,以提升最终答案的准确性。API 向用户开放 deepseek-reasoner 思维链的内容,以供用户查看、展示、蒸馏使用。

curl --request POST \
  --url https://api.glmbigmodel.me/v1/chat/completions \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "deepseek-reasoner",
    "messages": [
      {
        "role": "user",
        "content": "9.11 and 9.8, which is greater?"
      }
    ],
    "max_tokens": 4096
  }'
{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "deepseek-reasoner",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "reasoning_content": "让我一步步思考:\n1. 我们需要比较9.11和9.8的大小\n2. 两个数都是小数,我们可以直接比较\n3. 9.8 = 9.80\n4. 9.11 < 9.80\n5. 所以9.8更大",
      "content": "9.8 is greater than 9.11."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 15,
    "total_tokens": 25
  }
}

Google Gemini · Generate Content

POST /v1beta/models/{model}:generateContent POST /v1beta/models/{model}:streamGenerateContent

代理 Gemini API 请求。路径格式: /v1beta/models/{model_name}:{action}。 支持 generateContent(同步)和 streamGenerateContent?alt=sse(流式)两种模式。 使用图片、音频、代码、工具等生成内容。支持文本生成、视觉理解、音频处理、长上下文、代码执行、JSON 模式、函数调用等多种功能。

📝 同步生成

curl -X POST \
  "https://api.glmbigmodel.me/v1beta/models/gemini-2.5-pro:generateContent" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts":[{"text": "Write a story about a magic backpack."}]
    }]
  }'

🌊 流式生成(SSE)

curl -X POST \
  "https://api.glmbigmodel.me/v1beta/models/gemini-2.5-pro:streamGenerateContent?alt=sse" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts":[{"text": "用中文写一个关于魔法背包的故事"}]
    }]
  }'

📨 响应示例

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [{"text": "..."}]
      },
      "safetyRatings": [...],
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 10,
    "candidatesTokenCount": 256,
    "totalTokenCount": 266
  },
  "modelVersion": "gemini-2.5-pro",
  "responseId": "..."
}
💡 提示:使用流式输出时,URL 路径使用 :streamGenerateContent?alt=sse。API 中转站会以 SSE 方式透传响应。
提示:OpenAI/Anthropic/DeepSeek 接口开启流式输出请在请求体设置 stream: true;Gemini 接口请使用 :streamGenerateContent?alt=sse 端点。

Image 图像接口

给定文本提示和/或输入图片,模型将生成新的图片。

OpenAI Image Generations

POST /v1/images/generations
# 默认参数(ratio: "1:1", resolution: "2k")
curl -X POST https://image.glmbigmodel.me/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer API_KEY" \
  -d '{
    "model": "jimeng-4.0",
    "prompt": "壮丽的山水风景,超高分辨率",
    "ratio": "16:9",
    "resolution": "2k"
  }'

# 使用4K分辨率的示例
curl -X POST https://image.glmbigmodel.me/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer API_KEY" \
  -d '{
    "model": "nanobanana",
    "prompt": "壮丽的山水风景,超高分辨率",
    "ratio": "1:1",
    "resolution": "2k"
  }'
  • `response_format` 可选:`b64_json` / `url`

OpenAI Image Edits

POST /v1/images/edits
# 默认参数(ratio: "1:1", resolution: "2k")
curl -X POST https://image.glmbigmodel.me/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -F "prompt=A cute cat, anime style" \
  -F "model=nanobanana" \
  -F "images=@/path/to/your/local/cat.jpg"

# URL图片风格转换 (使用application/json)
curl -X POST https://image.glmbigmodel.me/v1/images/edits \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "nanobanana",
    "prompt": "将这张照片转换为油画风格,色彩鲜艳,笔触明显",
    "images": ["https://example.com/photo.jpg"],
    "ratio": "1:1",
    "resolution": "2k",
    "sample_strength": 0.7
  }'

# 示例3: 本地多文件上传 (使用multipart/form-data)
curl -X POST https://image.glmbigmodel.me/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -F "prompt=融合这两张图片" \
  -F "model=jimeng-4.0" \
  -F "images=@/path/to/your/image1.jpg" \
  -F "images=@/path/to/your/image2.png"
{
  "created": 1703123456,
  "data": [
    {
      "url": "https://p3-sign.toutiaoimg.com/tos-cn-i-tb4s082cfz/abc123.webp"
    }
  ],
  "input_images": 1,
  "composition_type": "multi_image_synthesis"
}

Gemini · 图像生成

POST /v1beta/models/{model}:generateContent gemini-3-pro-image-preview

使用 Google Gemini 原生 API 格式调用图像生成模型。通过 responseModalities 指定输出包含图像,通过 imageConfig 配置图像长宽比、分辨率、输出格式等参数。支持纯文本生成图片和图像编辑两种模式。

📷 生成图片(文本生成图像)

# 生成图片 - 4K 分辨率 + 16:9 长宽比(包含所有可配置参数)
curl -X POST \
  "https://api.glmbigmodel.me/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "生成一张壮丽的山水风景画,阳光穿透云层照耀在雪山之巅,前景是碧绿的湖水倒映着群山,超高清 4K 画质,16:9 宽屏比例"
          }
        ]
      }
    ],
    "generationConfig": {
      "temperature": 1,
      "maxOutputTokens": 32768,
      "responseModalities": ["TEXT", "IMAGE"],
      "topP": 0.95,
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "4K",
        "imageOutputOptions": {
          "mimeType": "image/png"
        },
        "personGeneration": "ALLOW_ALL"
      }
    },
    "safetySettings": [
      { "category": "HARM_CATEGORY_HATE_SPEECH", "threshold": "OFF" },
      { "category": "HARM_CATEGORY_DANGEROUS_CONTENT", "threshold": "OFF" },
      { "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT", "threshold": "OFF" },
      { "category": "HARM_CATEGORY_HARASSMENT", "threshold": "OFF" }
    ]
  }'

✏️ 图像编辑(基于图片修改)

# 图像编辑 - 使用 URL 图片进行风格转换
curl -X POST \
  "https://api.glmbigmodel.me/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "fileData": {
              "mimeType": "image/jpeg",
              "fileUri": "https://example.com/your-image.jpg"
            }
          },
          {
            "text": "将这张照片转换为卡通风格,保持 16:9 的宽屏比例,4K 超高清画质"
          }
        ]
      }
    ],
    "generationConfig": {
      "temperature": 1,
      "maxOutputTokens": 32768,
      "responseModalities": ["TEXT", "IMAGE"],
      "topP": 0.95,
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "4K",
        "imageOutputOptions": {
          "mimeType": "image/png"
        },
        "personGeneration": "ALLOW_ALL"
      }
    },
    "safetySettings": [
      { "category": "HARM_CATEGORY_HATE_SPEECH", "threshold": "OFF" },
      { "category": "HARM_CATEGORY_DANGEROUS_CONTENT", "threshold": "OFF" },
      { "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT", "threshold": "OFF" },
      { "category": "HARM_CATEGORY_HARASSMENT", "threshold": "OFF" }
    ]
  }'

# 图像编辑 - 使用 Base64 内嵌图片
curl -X POST \
  "https://api.glmbigmodel.me/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "'"$(base64 -w0 /path/to/your/image.png)"'"
            }
          },
          {
            "text": "将这张图片转换为黑白素描风格"
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "4K"
      }
    },
    "safetySettings": [
      { "category": "HARM_CATEGORY_DANGEROUS_CONTENT", "threshold": "OFF" }
    ]
  }'

📨 响应示例

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "这是按照您的要求生成/编辑的图片..."
          },
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "iVBORw0KGgoAAAANSUhEUgAA...(base64 编码,16:9 分辨率约 3840x2160)..."
            }
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "safetyRatings": [
        { "category": "HARM_CATEGORY_HATE_SPEECH", "probability": "NEGLIGIBLE" },
        { "category": "HARM_CATEGORY_DANGEROUS_CONTENT", "probability": "NEGLIGIBLE" },
        { "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT", "probability": "NEGLIGIBLE" },
        { "category": "HARM_CATEGORY_HARASSMENT", "probability": "NEGLIGIBLE" }
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 24,
    "candidatesTokenCount": 531,
    "totalTokenCount": 555,
    "promptTokensDetails": [
      { "modality": "TEXT", "tokenCount": 24 }
    ],
    "candidatesTokensDetails": [
      { "modality": "TEXT", "tokenCount": 15 },
      { "modality": "IMAGE", "tokenCount": 516 }
    ]
  },
  "modelVersion": "gemini-3-pro-image-preview"
}

⚙️ 参数说明

参数 类型 说明
responseModalities array 必须包含 ["TEXT", "IMAGE"]["IMAGE"] 才能输出图像
imageConfig.aspectRatio string 长宽比,可选值:1:12:33:23:44:34:55:49:1616:921:9
imageConfig.imageSize string 图像分辨率,可选值:1K(约 1024px)、2K(约 2048px)、4K(约 3840px)
imageConfig.imageOutputOptions.mimeType string 输出图像格式:image/pngimage/jpegimage/webp
imageConfig.personGeneration string 人物生成策略:ALLOW_ALL(允许)、DONT_ALLOW(禁止)
temperature number 创意度,范围 0.0-2.0,默认 1.0
topP number 核采样阈值,范围 0.0-1.0,默认 0.95
maxOutputTokens number 最大输出 token 数,建议设置为 32768
safetySettings array 安全设置数组,每项包含 categorythreshold
safetySettings[].category string 安全类别:HARM_CATEGORY_HATE_SPEECHHARM_CATEGORY_DANGEROUS_CONTENTHARM_CATEGORY_SEXUALLY_EXPLICITHARM_CATEGORY_HARASSMENT
safetySettings[].threshold string 阈值:OFF(关闭)、BLOCK_LOW_AND_ABOVEBLOCK_MEDIUM_AND_ABOVEBLOCK_ONLY_HIGH
⚠️ 注意:gemini-3-pro-image-preview 为预览版模型,号池容量有限,高峰期可能出现排队。图像以 Base64 编码的 inlineData 返回。使用 imageSize: "4K" + aspectRatio: "16:9" 时,输出分辨率约为 3840x2160。