model 设为 Gemini 模型名即可。
支持的接口
| 接口 | 路径 | 说明 |
|---|---|---|
| Chat Completions | /v1/chat/completions | 对话生成 |
| Embeddings | /v1/embeddings | 向量嵌入 |
| Images | /v1/images/generations | 图像生成 |
Chat Completions
curl -X POST "https://models.phanedge.cloud/v1/chat/completions" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-2.5-flash",
"messages": [
{"role": "system", "content": "你是一个助手"},
{"role": "user", "content": "你好"}
]
}'
流式输出
curl -N "https://models.phanedge.cloud/v1/chat/completions" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-2.5-flash",
"messages": [{"role": "user", "content": "写一首诗"}],
"stream": true
}'
多模态
curl -X POST "https://models.phanedge.cloud/v1/chat/completions" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-2.5-flash",
"messages": [{
"role": "user",
"content": [
{"type": "text", "text": "描述图片"},
{"type": "image_url", "image_url": {"url": "data:image/png;base64,..."}}
]
}]
}'
Chat 图像能力（gemini-2.5-flash-image-preview）
当你希望在对话中直接生成或编辑图片时，可使用gemini-2.5-flash-image-preview：
curl -X POST "https://models.phanedge.cloud/v1/chat/completions" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-2.5-flash-image-preview",
"messages": [
{"role": "user", "content": "生成一张现代感办公室的插画"}
]
}'
工具调用
curl -X POST "https://models.phanedge.cloud/v1/chat/completions" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-2.5-flash",
"messages": [{"role": "user", "content": "北京天气"}],
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"parameters": {"type": "object", "properties": {"city": {"type": "string"}}}
}
}]
}'
思考模式
curl -X POST "https://models.phanedge.cloud/v1/chat/completions" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-2.5-flash",
"messages": [{"role": "user", "content": "计算 23*47"}],
"reasoning_effort": "medium"
}'
Embeddings
curl -X POST "https://models.phanedge.cloud/v1/embeddings" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "text-embedding-004",
"input": "文本内容"
}'
Images
curl -X POST "https://models.phanedge.cloud/v1/images/generations" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "imagen-3.0-generate-001",
"prompt": "a cat reading",
"size": "1024x1024"
}'
参数映射
平台自动完成格式转换：| OpenAI 参数 | Gemini 参数 |
|---|---|
messages | contents |
tools | functionDeclarations |
response_format | responseMimeType |
reasoning_effort | thinkingConfig |
max_tokens | maxOutputTokens |
SDK 示例
Python
from openai import OpenAI
client = OpenAI(
api_key="your-token",
base_url="https://models.phanedge.cloud/v1"
)
# 对话
response = client.chat.completions.create(
model="gemini-2.5-flash",
messages=[{"role": "user", "content": "你好"}]
)
# 流式
for chunk in client.chat.completions.create(
model="gemini-2.5-flash",
messages=[{"role": "user", "content": "写诗"}],
stream=True
):
print(chunk.choices[0].delta.content or "", end="")
# 向量
embedding = client.embeddings.create(
model="text-embedding-004",
input="文本"
)
Node.js
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'your-token',
baseURL: 'https://models.phanedge.cloud/v1'
});
const response = await client.chat.completions.create({
model: 'gemini-2.5-flash',
messages: [{ role: 'user', content: '你好' }]
});
Gemini 专用入口
除统一入口外，也可使用 Gemini 专用的 OpenAI 兼容路径：/v1beta/openai/chat/completions
/v1beta/openai/embeddings
/v1beta/openai/images/generations