银河杂货铺 · 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` 指向银河中转即可。
绘图模型介绍
主要介绍一些绘图模型的调用方法
| 模型 | 调用方法 | 参数适配 | 注意事项 |
|---|---|---|---|
| nanobanana | 不支持设置大小,宽高等 参数 |
逆向模型,支持文生图/图生图 | |
| jimeng-4.0 jimeng-4.1 jimeng-4.5 |
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 |
Ratio: 16:9,9:16,1:1,2:3,3:2 | 分别支持文生图和图生图 | |
| gemini-3-pro- image-preview (Nano Banana Pro) |
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
完整兼容 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
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
给定一组包含文本和/或图像内容的结构化输入消息列表,模型将生成对话中的下一条消息。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
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
代理 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": "..."
}
:streamGenerateContent?alt=sse。API 中转站会以 SSE 方式透传响应。
stream: true;Gemini 接口请使用
:streamGenerateContent?alt=sse 端点。
Image 图像接口
给定文本提示和/或输入图片,模型将生成新的图片。
OpenAI Image 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
# 默认参数(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 · 图像生成
使用 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:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9
|
imageConfig.imageSize |
string | 图像分辨率,可选值:1K(约 1024px)、2K(约 2048px)、4K(约 3840px) |
imageConfig.imageOutputOptions.mimeType |
string | 输出图像格式:image/png、image/jpeg、image/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 | 安全设置数组,每项包含 category 和 threshold |
safetySettings[].category |
string |
安全类别:HARM_CATEGORY_HATE_SPEECH、HARM_CATEGORY_DANGEROUS_CONTENT、HARM_CATEGORY_SEXUALLY_EXPLICIT、HARM_CATEGORY_HARASSMENT
|
safetySettings[].threshold |
string |
阈值:OFF(关闭)、BLOCK_LOW_AND_ABOVE、BLOCK_MEDIUM_AND_ABOVE、BLOCK_ONLY_HIGH
|
gemini-3-pro-image-preview 为预览版模型,号池容量有限,高峰期可能出现排队。图像以 Base64 编码的 inlineData
返回。使用 imageSize: "4K" + aspectRatio: "16:9" 时,输出分辨率约为 3840x2160。