Spark Dream 4.5

Authentication

authorization `string` required

All APIs require authentication via Bearer Token.

Get API Key:

Visit API Key Management Page to get your API Key.

Usage:

Add to request header:

Authorization: Bearer YOUR_API_KEY

Parameters

model `string` required

Model ID to use for the request

Value: spark_dream_4_5

prompt `string` required

Prompt for image generation, supports both Chinese and English

Recommended not to exceed 300 Chinese characters or 600 English words. Too many characters may cause information dispersion, and the model may ignore details, focusing only on key points, resulting in missing elements in the image

image `string` | `array`

Input image information, supports URL or Base64 encoding, supports single or multiple image input

Image URL: Ensure the image URL is accessible
Base64 encoding: Follow this format data:image/<image_format>;base64,<Base64_encoding>. Note that <image_format> should be lowercase, e.g., data:image/png;base64,<base64_image>

Image requirements:
Supported formats: JPEG, PNG, WebP, BMP, TIFF, GIF
Aspect ratio (width/height) range: 1/16 to 16
Width and height (px) > 14
Size: not exceeding 10MB
Total pixels: not exceeding 6000x6000=36000000 px (limit on the pixel product of single image width and height, not on individual width or height values)
Maximum 14 reference images supported

size `string`

Specify the size information of the generated image. Supports two methods, cannot be mixed

Method 1: Specify the resolution of the generated image, and describe the aspect ratio, shape, or usage in the prompt using natural language
Available values: 2K, 4K

Method 2: Specify the width and height pixel values
Total pixel range: 2560x1440=3686400 to 4096x4096=16777216
Aspect ratio range: 1/16 to 16

When using Method 2, both the total pixel range and aspect ratio range must be satisfied. Total pixels is a limit on the pixel product of single image width and height, not on individual width or height values

Valid example: 3750x1250
Total pixel value 3750x1250=4687500, meets the range requirement [3686400, 16777216]. Aspect ratio 3750/1250=3, meets the range requirement [1/16, 16], so this example value is valid

Invalid example: 1500x1500
Total pixel value 1500x1500=2250000, does not meet the minimum requirement 3686400. Aspect ratio 1500/1500=1, although meets the range requirement [1/16, 16], but because it does not satisfy both constraints simultaneously, this example value is invalid

Recommended width and height pixel values:
1:1: 2048x2048
4:3: 2304x1728
3:4: 1728x2304
16:9: 2560x1440
9:16: 1440x2560
3:2: 2496x1664
2:3: 1664x2496
21:9: 3024x1296

Default: 2048x2048

sequential_image_generation `string`

Control whether to disable the image group feature

Image group: A set of content-related images generated based on your input

auto: Automatic mode, the model will determine whether to return image groups and the number of images based on the prompt
disabled: Disable image group feature, the model will only generate one image

Options: auto, disabled

Default: disabled

sequential_image_generation_options `object`

Configuration for image group feature. Only effective when sequential_image_generation is auto

max_images integer

Specify the maximum number of images that can be generated in this request

The actual number of images that can be generated is also affected by the number of input reference images. Number of input reference images + final generated images ≤ 15

Range: 1 to 15

Default: 15

stream `boolean`

Control whether to enable streaming output mode

false: Non-streaming output mode, returns all information at once after all images are generated
true: Streaming output mode, returns results for each image immediately. Streaming output mode is effective for both single image and image group scenarios

Options: true, false

Default: false

watermark `boolean`

Whether to add watermark to the generated image

false: No watermark
true: Add “AI Generated” watermark in the bottom right corner

Options: true, false

Default: true

optimize_prompt_options `object`

Configuration for prompt optimization feature. Currently only supports standard mode

mode string

Set the mode for prompt optimization feature

standard: Standard mode, higher quality content generation, longer processing time

Options: standard

Default: standard

Polling

Since image generation takes time, you need to poll the task status after creation

The initial response returns the task ID and initial status. The actual generation results must be obtained through polling the task status endpoint

Response Format

error `object`

Error information. Only present when status is failed

code string

Error code

error_message string

Detailed error message

output `object`

Generation result output

content array

List of generated images

type string

Resource type

Value: image

url string

Image URL

usage `object`

Usage statistics. Only present when status is completed

cost string

Total cost in USD

discount number

Discount amount

metadata `object`

Metadata information

Error Codes

Error Code	Description
003025001	Prompt parameter missing
003025002	Maximum image count exceeded (max 14)
003025095	Internal generation error
003025096	Result parsing error
003025097	HTTP error response
003025099	Synchronous generation error

curl --location 'https://cloud.vtrix.ai/model/v1/generation' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --data '{ "model": "spark_dream_4_5", "input": [ { "params": { "prompt": "生成3张女孩和奶牛玩偶在游乐园开心地坐过山车的图片，涵盖早晨、中午、晚上", "image": ["https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_1.png", "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_2.png"], "sequential_image_generation": "auto", "sequential_image_generation_options": { "max_images": 3 }, "size": "2K", "watermark": false } } ] }'

{ "id": "d5u5obte8783ap44qtj0", "created_at": 1769757744021, "status": "completed", "model": "spark_dream_4_5", "output": [ { "content": [ { "type": "image", "url": "https://example.com/generated-image.jpg" } ] } ], "usage": { "cost": "0.000500", "discount": 0, "input_tokens": null, "output_tokens": null, "quantity": 1, "time_per_unit": 0, "total_tokens": null, "unit_price": "0.000500", "user_discount": 1 }, "metadata": { "completed_at": 120.5, "in_queue_at": 0, "upload_at": 1.2, "usage": { "input_tokens": 20, "input_tokens_details": { "text_tokens": 20 }, "output_tokens": 0, "total_tokens": 20 } } }

Authentication

authorization `string` required

Parameters

model `string` required

prompt `string` required

image `string` | `array`

size `string`

sequential_image_generation `string`

sequential_image_generation_options `object`

max_images `integer`

stream `boolean`

watermark `boolean`

optimize_prompt_options `object`

mode `string`

Polling

Response Format

error `object`

code `string`

error_message `string`

output `object`

content `array`

type `string`

url `string`

usage `object`

cost `string`

discount `number`

metadata `object`

Error Codes

Authentication

authorization string required

Parameters

model string required

prompt string required

image string | array

size string

sequential_image_generation string

sequential_image_generation_options object

max_images integer

stream boolean

watermark boolean

optimize_prompt_options object

mode string

Polling

Response Format

error object

code string

error_message string

output object

content array

type string

url string

usage object

cost string

discount number

metadata object

Error Codes

authorization `string` required

model `string` required

prompt `string` required

image `string` | `array`

size `string`

sequential_image_generation `string`

sequential_image_generation_options `object`

max_images `integer`

stream `boolean`

watermark `boolean`

optimize_prompt_options `object`

mode `string`

error `object`

code `string`

error_message `string`

output `object`

content `array`

type `string`

url `string`

usage `object`

cost `string`

discount `number`

metadata `object`