Skip to main content
  • 快速生成速度,针对快速图像创建进行优化
  • 生成的图像链接,有效期为24小时,请尽快保存
curl --request POST \
  --url https://claw.dualseason.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-2.5-flash-image-preview",
    "prompt": "月光下的竹林小径",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      "https://openai-documentation.vercel.app/images/cat_and_otter.png"
    ]
  }'
{
  "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-2.5-flash-image-preview"
required
图像生成模型名称支持的模型:
  • gemini-2.5-flash-image-preview - 标准版本
  • gemini-2.5-flash-image-preview-official - 官方版本
示例:"gemini-2.5-flash-image-preview""gemini-2.5-flash-image-preview-official"
prompt
string
required
图像生成的文本描述最长 1000 个字符
size
string
图像生成的尺寸支持的格式:
  • 比例:1:12:33:23:44:34:55:49:1616:921:9
resolution
string
default:"1K"
输出图像分辨率支持的值:
  • 1K - 1K 分辨率(默认)
n
integer
生成图像的数量取值范围:1-4(最少 1 张,最多 4 张)⚠️ 注意: 必须输入纯数字(如 1),不要加引号,否则会报错
official_fallback
boolean
default:"false"
是否使用官方渠道兜底
  • false:不使用(默认)
  • true:使用官方渠道
当使用官方渠道(gemini-2.5-flash-image-preview-official)时,不能使用此参数。
image_urls
array
参考图像的 URL 列表,用于图生图或图像编辑💡 快速填写(Try it 区域):
  1. 点击 ”+ Add an item” 添加一个图像URL
  2. 输入图像的完整 URL 地址或base64数据
限制: 最多 14 张图片

Response

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