← 返回做图页面 📋 项目文档

📖 Gemini AI 做图 API 文档

基于 Google Gemini 的 AI 图片生成接口 · 最后更新: 2026-02-24

🔑 鉴权

所有接口需要鉴权，二选一：

// 方式1: Header
Authorization: Bearer gemini_2026

// 方式2: URL参数
?key=gemini_2026

📡 接口列表

POST /api/generate 文生图

根据文字描述生成图片，支持中英文提示词。通常耗时 10-30 秒。

请求参数 (JSON Body)

字段类型必填说明
promptstring必填图片描述，中英文均可
return_base64boolean可选是否在返回中包含 base64 数据，默认 false

请求示例

{
  "prompt": "一只戴墨镜的橘猫在海滩冲浪，数字艺术风格"
}

成功返回

{
  "success": true,
  "count": 1,
  "text": null,
  "images": [
    {
      "index": 0,
      "path": "output/2026-02-21/gen_1234567_0/xxx.png",
      "url": "/images/2026-02-21/gen_1234567_0/xxx.png",
      "base64": "...(仅 return_base64=true 时存在)",
      "mime_type": "image/png"
    }
  ]
}

查看/下载图片：拼接域名 + url 字段，如：
http://gemini.666douyin.cn/images/2026-02-21/gen_xxx/xxx.png

curl 示例

curl -X POST http://gemini.666douyin.cn/api/generate \
  -H "Authorization: Bearer gemini_2026" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a cute cat wearing sunglasses, digital art"}'

Python 示例

import requests

resp = requests.post(
    "http://gemini.666douyin.cn/api/generate",
    headers={"Authorization": "Bearer gemini_2026"},
    json={"prompt": "一只可爱的猫咪"},
    timeout=60  # 重要：设置足够长的超时！
)
data = resp.json()
if data["success"]:
    img_url = "http://gemini.666douyin.cn" + data["images"][0]["url"]
    print("图片地址:", img_url)

JavaScript 示例

const resp = await fetch("http://gemini.666douyin.cn/api/generate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer gemini_2026",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ prompt: "a cute cat" })
});
const data = await resp.json();
if (data.success) {
  const imgUrl = "http://gemini.666douyin.cn" + data.images[0].url;
  console.log("图片地址:", imgUrl);
}
POST /api/edit 图片编辑

对已有图片进行 AI 编辑修改。

请求参数 (JSON Body)

字段类型必填说明
promptstring必填编辑描述，如"给人物加上墨镜"、"把背景换成星空"
image_urlstring三选一本服务生成的图片路径，如 /images/2026-02-21/gen_xxx/xxx.png
image_base64string图片的 base64 编码数据（适合上传外部图片）
image_pathstring服务器上的本地文件绝对路径

请求示例（图生图 - 上传外部图片）

# Python 图生图示例
import requests, base64

with open("my_photo.jpg", "rb") as f:
    img_b64 = base64.b64encode(f.read()).decode()

resp = requests.post("http://gemini.666douyin.cn/api/edit",
    headers={"Authorization": "Bearer gemini_2026"},
    json={"prompt": "改成赛博朋克风格", "image_base64": img_b64},
    timeout=90)
print(resp.json())

请求示例（编辑已生成的图片）

{
  "prompt": "把背景换成星空",
  "image_url": "/images/2026-02-21/gen_1234567_0/xxx.png"
}

返回格式

同文生图接口，返回编辑后的新图片。

POST /api/cookie 更新Cookie

当 Google Cookie 过期时，调用此接口热更新，无需重启服务。

请求参数

字段类型必填说明
psidstring必填Google __Secure-1PSID cookie 值
psidtsstring可选Google __Secure-1PSIDTS cookie 值

返回

{"success": true, "message": "Cookie updated and verified"}
GET /api/status 服务状态

查询服务运行状态和 Cookie 是否有效。

返回

{
  "status": "running",
  "has_cookie": true,
  "cookie_prefix": "g.a0007Ah...",
  "client_initialized": true
}
GET /images/{path} 查看图片

直接访问生成的图片文件。可用于 <img> 标签、浏览器打开或下载。

无需鉴权。

⚠️ 注意事项

超时设置：生图通常需要 10-30 秒，请将 HTTP 超时设置为至少 60 秒，否则会超时报错。
内容限制：Gemini 会拒绝生成暴力、色情等违规内容，此时返回 success: false。
Cookie 过期：Google Cookie 会定期过期（通常几天到几周），过期后接口会返回 401 错误，调用 /api/cookie 更新即可。
并发限制：建议串行调用，避免同时发送多个生图请求，否则可能触发 Google 限流。

🔧 错误码

HTTP状态码含义处理方式
200成功（检查 success 字段）-
400参数错误检查请求体格式和必填字段
401鉴权失败或Cookie过期检查 API Key 或更新 Cookie
404图片不存在检查 image_url 路径
500服务器内部错误查看返回的 error 字段
Gemini AI 做图 API · Powered by Google Gemini · 在线体验