Skip to main content
  • 最多 14 张参考图，保持风格/角色一致性
  • 支持极端宽高比（1:4、4:1、1:8、8:1）
  • 集成 Google Search 搜索增强，生成更贴合真实世界的图片
curl --request POST \
  --url https://claw.dualseason.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "赛博朋克风格的城市夜景，霓虹灯闪烁",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

​
Authorizations

​
Authorization
string
required
所有接口均需要使用Bearer Token进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
default:"gemini-3.1-flash-image-preview"
required
图像生成模型名称支持的模型：
  • gemini-3.1-flash-image-preview - 标准版本
  • gemini-3.1-flash-image-preview-official - 官方版本
示例："gemini-3.1-flash-image-preview" 或 "gemini-3.1-flash-image-preview-official"
​
prompt
string
required
图像生成的文本描述
​
size
string
图像生成的宽高比支持的比例：
  • 1:1 - 方形图、头像、社交媒体
  • 3:2 / 2:3 - 标准照片
  • 4:3 / 3:4 - 传统显示器比例
  • 16:9 / 9:16 - 宽屏/竖屏视频封面
  • 5:4 / 4:5 - Instagram 图片
  • 21:9 - 超宽屏 Banner
  • 1:4 / 4:1 - 长条海报/横幅
  • 1:8 / 8:1 - 极端长图/横幅广告
​
resolution
string
default:"1K"
输出图像分辨率支持的值：
  • 0.5K - 约 512px，低分辨率预览
  • 1K - 约 1024px，标准分辨率（默认）
  • 2K - 约 2048px，高分辨率
  • 4K - 约 4096px，超高分辨率
注意： 不同分辨率计费不同，4K 价格高于 1K
​
n
integer
生成图像的数量取值范围：1-4（最少 1 张，最多 4 张）⚠️ 注意： 必须输入纯数字（如 1），不要加引号，否则会报错
​
official_fallback
boolean
default:"false"
是否使用官方渠道兜底
  • false：不使用（默认）
  • true：使用官方渠道
当使用官方渠道（gemini-3.1-flash-image-preview-official）时，不能使用此参数。
​
image_urls
array
参考图像的 URL 列表，用于图生图支持两种格式：1. 完整的图像URL地址
  • 公开可访问的图像URL（http:// 或 https://）
  • 示例：https://example.com/image.jpg
2. Base64 编码格式
  • 必须使用完整的 Data URI 格式
  • 格式：data:image/{格式};base64,{base64数据}
  • 支持的图片格式：jpeg、png、webp
  • 示例：data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ 注意：必须包含 data:image/jpeg;base64, 前缀部分
限制：
  • 最多 14 张参考图（建议：最多 10 张物体参考 + 4 张角色参考）
  • 单张图片不超过 10MB
  • 支持格式：jpeg、png、webp
​
google_search
boolean
default:"false"
启用 Google 文字搜索增强
  • true：模型会先搜索网络文字信息来辅助生成图片，适合需要真实信息的场景
  • false：不启用（默认）
​
google_image_search
boolean
default:"false"
启用 Google 图片搜索增强
  • true：除了文字搜索，还会搜索参考图片来辅助生成，适合需要视觉参考的场景
  • false：不启用（默认）
注意： 需要配合 google_search: true 一起使用

​
Response

​
code
integer
响应状态码
​
data
array
返回数据数组