Skip to main content
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "一只橘猫趴在窗台上晒太阳，水彩画风格",
    "size": "16:9"
  }'

{
  "code": "success",
  "data": "task-wave17200000001234567890abcdef"
}
Async processing mode — submit a request and receive a task ID. Use the Query Task Status endpoint to retrieve generation results. 
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "一只橘猫趴在窗台上晒太阳，水彩画风格",
    "size": "16:9"
  }'

{
  "code": "success",
  "data": "task-wave17200000001234567890abcdef"
}

​
Available Models

Model IDDescription
gemini-2.5-flash-image-previewGemini 2.5 Flash image preview
gemini-3-pro-image-previewGemini 3 Pro image preview
gemini-3.1-flash-image-previewGemini 3.1 Flash image preview with high-resolution and search enhancement support

​
Common Parameters

​
model
string
required
Model ID, see the model list above
​
prompt
string
required
Image description text, maximum 1000 characters
​
image_urls
array
Reference image URL array, up to 14 images, each up to 10MB
​
n
integer
default:"1"
Number of images to generate, fixed at 1

​
Model-Specific Parameters

​
size
string
default:"1:1"
Image aspect ratioSupported: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
​
resolution
string
default:"1K"
Output resolution: 1K

​
Response

Returns a task ID. Use Query Task Status to retrieve the final image result.
​
code
string
Status code, "success" on success
​
data
string
Task ID, formatted as task-wave{timestamp}{userId}{random}