Seedream · Image

Reference to ImageNEW

📌 What is this：Generate new images based on the subjects / style of reference images (image-to-image / multi-reference).

💡 When to use：Use to keep a given character, product or style while changing the scene / composition; sending imageUrls means reference mode.

Endpoints

Usage	Method	Path
Submit task	POST	/api/cqt/generator/seedream
Query Result	GET	/api/cqt/info/seedream?id={taskId}

⏱ Recommended polling interval：Poll every 5-10s until status = succeeded / failed.

Sub-models

The tier price column is credits/image (credits/call for per-call models); (default output) = default output only, resolution not accepted; ≥N refs → = multi-reference tier.

model	Usage	Materials	Images	Tier price (credits)
seedream-5.0-pro	5.0 Pro; quality first	≤4 reference images	1	2K=60 / 4K=72 ; +2/ref after 1
seedream-5.0-lite	5.0 Lite; 2K only	≤4 reference images	1	2K=22
seedream-4.5	4.5; 2K / 4K same price	≤4 reference images	1	2K=25 / 4K=25
seedream-4.0	4.0; 2K / 4K same price	≤4 reference images	1	2K=20 / 4K=20

⚠ seedream-5.0-pro: 1 image per call; seedream-5.0-lite: 1 image per call; seedream-4.5: 1 image per call; seedream-4.0: 1 image per call

Request Parameters

Param	Type	Required	Description
model	string	Required	Sub-model: seedream-5.0-pro / seedream-5.0-lite / seedream-4.5 / seedream-4.0
prompt	string	—	Image description (optional)
imageUrls	array	Required	Reference image URL array (publicly reachable); limit per the table
resolution	string	—	1K / 2K / 4K, only tiers priced in the table, default = lowest tier; accepted only by seedream-5.0-pro / seedream-5.0-lite / seedream-4.5 / seedream-4.0 (others use the default output and reject it)
aspectRatio	string	—	Aspect ratio, e.g. 1:1 / 16:9 / 9:16
negativePrompt / seed / enhancePrompt	string / integer / boolean	—	Negative prompt / random seed / auto-enhance prompt (optional)

Request Example

curl -X POST https://api.cqtai.com/api/cqt/generator/seedream \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedream-5.0-pro",
    "prompt": "the same woman sitting in a cozy cafe by the window on a rainy day, soft light",
    "resolution": "2K",
    "imageUrls": [
      "https://cdn.novapi.ai/kling/1791949942892_d18ee23dfa3048e097c58c9c3e32a754.png"
    ],
    "aspectRatio": "16:9"
  }'
# -> { "code":200, "data":"<taskId>" }

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "7bf7d9f498b24b288cdc18b4e207e86d",
    "resultUrl": "https://cdn.novapi.ai/seedream/1791950068848_3f85817c4cd141c4b96e18780be3e8fe.jpg",
    "status": "succeeded",
    "errorMsg": null,
    "createTime": "2026-10-14 11:53:29",
    "completeTime": "2026-10-14 11:54:29"
  }
}

Response Fields

Field	Type	Description
code	number	200 means success
data.id	string	Task ID (taskId)
data.status	string	queued / running / succeeded / failed
data.resultUrl	string	Result URL(s) on our CDN (long-lived); multiple results are comma-separated; null until done or on failure
data.errorMsg	string \| null	Failure reason; null on success