API 文档

把本站当作你的图像生成上游，API 密钥在「个人中心」创建

1. 推荐使用异步接口：提交返回 task_id 再轮询结果，适合批量任务、并发调用与断网恢复，不受网关超时影响。

2. 参考图传 URL 拉取失败时，可改传 base64（inlineData）。

3. 生成失败或超时均自动退款；单次生成硬超时 180 秒。

鉴权方式（三选一）

# 1. Authorization 头（推荐）
Authorization: Bearer YOUR_API_KEY

# 2. x-goog-api-key 头（Gemini 官方 SDK 默认）
x-goog-api-key: YOUR_API_KEY

# 3. URL 参数（仅调试用，会在日志留明文）
https://your-domain.com/api/gemini/v1beta/models/MODEL:generateContent?key=YOUR_API_KEY

① 异步任务接口（推荐）

提交立即返回 task_id，任务由服务器后台处理，轮询建议间隔 3~5 秒。模型名放 body 顶层 model 字段。

# 提交任务
curl -X POST https://your-domain.com/api/gemini/v1beta/asyncGenerateContent \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image-preview",
    "contents": [{ "role": "user", "parts": [{ "text": "画一只穿宇航服的猫" }] }],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": { "aspectRatio": "1:1", "imageSize": "1K" }
    }
  }'

# 返回
{ "task_id": "taskId_xxx", "status": "submitted", "created": 1780236429 }

# 轮询状态
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://your-domain.com/api/gemini/v1beta/tasks/taskId_xxx

# 处理中 → { "task_id": "...", "status": "processing" }
# 完成   → { "status": "completed", "response": { "candidates": [ { "content": { "parts": [
#            { "fileData": { "mimeType": "image/jpeg", "fileUri": "https://your-domain.com/uploads/....jpg" } } ] } } ] } }
# 失败   → { "status": "failed", "error": { "message": "...", "type": "task_failed" } }  # 已自动退款

② 同步直连接口

阻塞等待出图后按 Gemini 原生格式返回 base64（inlineData），官方 SDK 零改造可用。模型名放 URL。建议客户端超时 ≥ 200 秒。

curl -X POST \
  "https://your-domain.com/api/gemini/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 200 \
  -d '{
    "contents": [{ "role": "user", "parts": [{ "text": "画一只穿宇航服的猫" }] }],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": { "aspectRatio": "16:9", "imageSize": "2K", "outputMimeType": "image/png" }
    }
  }'

# 返回（Gemini 原生格式）
{ "candidates": [ { "content": { "role": "model", "parts": [
    { "inlineData": { "mimeType": "image/jpeg", "data": "<base64...>" } } ] },
    "finishReason": "STOP" } ], "modelVersion": "..." }

带参考图（图生图）

参考图放 contents[].parts，支持 imageUrl 或 inlineData，最多 14 张，两种接口通用。

{
  "contents": [{ "role": "user", "parts": [
    { "text": "参考这张图，换成水彩风格" },
    { "imageUrl": "https://example.com/ref.jpg" },
    { "inlineData": { "mimeType": "image/png", "data": "<base64...>" } }
  ]}],
  "generationConfig": { "responseModalities": ["IMAGE"], "imageConfig": { "aspectRatio": "1:1", "imageSize": "1K" } }
}

支持的模型与价格

模型 ID	名称	1K	2K	4K	支持比例

用量查询

登录网页「使用记录」可查看全部任务（含 API 调用）与余额流水；生成的图片在网页生成记录中同步可见。