生图模型
Gemini 3.1 Flash Image
说明 `gemini-3.1-flash-image-preview` 在当前项目中的接入方式：它属于 Gemini 原生模型，不走统一图片接口。
- 当前项目不会通过
POST /v1/images/generations暴露该模型 - 该模型在项目中属于 Gemini 原生模型接入面
- 调用路由应使用
POST /v1beta/models/{model}:{action}
推荐路由
POST /v1beta/models/gemini-3.1-flash-image-preview:{action}常见动作：
generateContentstreamGenerateContent
可直接复制的调用示例
cURL
curl --request POST \
--url https://api.magickapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "生成一张赛博朋克风格的城市夜景。"
}
]
}
]
}'Python
import json
import requests
url = "https://api.magickapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
}
payload = {
"contents": [
{
"role": "user",
"parts": [
{
"text": "生成一张赛博朋克风格的城市夜景。"
}
],
}
]
}
response = requests.post(url, headers=headers, json=payload, timeout=300)
response.raise_for_status()
result = response.json()
print(json.dumps(result, ensure_ascii=False, indent=2))Node.js
const url =
"https://api.magickapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent";
const payload = {
contents: [
{
role: "user",
parts: [
{
text: "生成一张赛博朋克风格的城市夜景。",
},
],
},
],
};
const response = await fetch(url, {
method: "POST",
headers: {
Authorization: "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify(payload),
});
if (!response.ok) {
throw new Error(await response.text());
}
const result = await response.json();
console.log(JSON.stringify(result, null, 2));响应说明
该模型返回 Gemini 原生 JSON 结构，不会转换成统一图片接口的：
{
"data": [
{
"url": "..."
}
]
}具体输出结构请按 Gemini 原生协议解析，并参考“通用模型 / Gemini 原生格式”页面。
最后更新于