seedream-v4/text-to-image

POST

/openapi/v2/seedream-v4/text-to-image

ByteDance’s layout-focused text-to-image model, generates structured grids, triptychs, and comic layouts with whitespace for text/CTAs. Ensures consistent aesthetics across multi-frame series and delivers 4K outputs (4096×4096) for marketing assets.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "prompt": "A professional 2x2 grid poster series titled \"The Harmony of Zen.\" Panel 1: A wide minimalist shot of a traditional Japanese tea room with soft morning light. Panel 2: A macro close-up of a green tea whisk with delicate bamboo textures. Panel 3: A medium shot of a single cherry blossom branch in a ceramic vase. Panel 4: A top-down view of steam rising from a ceramic tea cup. Design Requirements: All panels must share a consistent muted earth-tone palette and soft cinematic lighting. Leave a clean, horizontal whitespace bar in the upper center across the grid for a title placeholder.",
    "width": 2048,
    "height": 2048,
    "sequentialImageGeneration": "disabled",
    "maxImages": 1
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.runninghub.ai/openapi/v2/seedream-v4/text-to-image' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "A professional 2x2 grid poster series titled \"The Harmony of Zen.\" Panel 1: A wide minimalist shot of a traditional Japanese tea room with soft morning light. Panel 2: A macro close-up of a green tea whisk with delicate bamboo textures. Panel 3: A medium shot of a single cherry blossom branch in a ceramic vase. Panel 4: A top-down view of steam rising from a ceramic tea cup. Design Requirements: All panels must share a consistent muted earth-tone palette and soft cinematic lighting. Leave a clean, horizontal whitespace bar in the upper center across the grid for a title placeholder.",
    "width": 2048,
    "height": 2048,
    "sequentialImageGeneration": "disabled",
    "maxImages": 1
}'

Responses

🟢200成功

application/json

Task result query endpoint: /openapi/v2/query

Body

Examples

Submit response exampleTask success response example

{
    "taskId": "2013508786110730241",
    "status": "RUNNING",
    "errorCode": "",
    "errorMessage": "",
    "results": null,
    "clientId": "f828b9af25161bc066ef152db7b29ccc",
    "promptTips": "{\"result\": true, \"error\": null, \"outputs_to_execute\": [\"4\"], \"node_errors\": {}}"
}

Modified at 2026-03-11 04:00:02

seedream-v5-lite/text-to-image

grok-image/text-to-image/channel-low-price