Seedream 5.0 Lite text to image: Precise Text-to-Image with Layout Control | RunComfy
Generate high-fidelity visuals from text or reference images with precise layout, multilingual text accuracy, and real-time style control for brand, product, and marketing design tasks.
Table of contents
1. Get started
Use RunComfy's API to run bytedance/seedream-5/lite/text-to-image. For accepted inputs and outputs, see the model's schema.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/bytedance/seedream-5/lite/text-to-image \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "A vibrant close-up editorial portrait featuring a model with a sharp, piercing gaze, wearing a sculptural hat. Rich color blocking, crisp focus on the eyes, and a shallow depth of field create a striking visual impact. Styled with a Vogue cover aesthetic, captured in medium format, with bold and dramatic studio lighting."
}'2. Authentication
Set the YOUR_API_TOKEN environment variable with your API key (manage keys in your Profile) and include it on every request as a Bearer token via the Authorization header: Authorization: Bearer $YOUR_API_TOKEN.
3. API reference
Submit a request
Submit an asynchronous generation job and immediately receive a request_id plus URLs to check status, fetch results, and cancel.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/bytedance/seedream-5/lite/text-to-image \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "A vibrant close-up editorial portrait featuring a model with a sharp, piercing gaze, wearing a sculptural hat. Rich color blocking, crisp focus on the eyes, and a shallow depth of field create a striking visual impact. Styled with a Vogue cover aesthetic, captured in medium format, with bold and dramatic studio lighting."
}'Monitor request status
Fetch the current state for a request_id ("in_queue", "in_progress", "completed", or "cancelled").
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"Retrieve request results
Retrieve the final outputs and metadata for the given request_id; if the job is not complete, the response returns the current state so you can continue polling.
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"Cancel a request
Cancel a queued job by request_id, in-progress jobs cannot be cancelled.
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"4. File inputs
Hosted file (URL)
Provide a publicly reachable HTTPS URL. Ensure the host allows server‑side fetches (no login/cookies required) and isn't rate‑limited or blocking bots. Recommended limits: images ≤ 50 MB (~4K), videos ≤ 100 MB (~2–5 min @ 720p). Prefer stable or pre‑signed URLs for private assets.
5. Schema
Input schema
{
"type": "object",
"title": "Input",
"required": [
"prompt"
],
"properties": {
"prompt": {
"title": "Prompt",
"description": "The recommended length is no more than 600 English words. If the prompt is too long, the information may become scattered. The model might ignore details and only concentrate on the main points, resulting in a image with missing elements.",
"type": "string",
"default": "A vibrant close-up editorial portrait featuring a model with a sharp, piercing gaze, wearing a sculptural hat. Rich color blocking, crisp focus on the eyes, and a shallow depth of field create a striking visual impact. Styled with a Vogue cover aesthetic, captured in medium format, with bold and dramatic studio lighting."
},
"resolution": {
"title": "Resolution",
"description": "For 2K and 3K options, it will let the model determine the width and height. You should describe its aspect ratio, shape, or purpose in the prompt using natural language. For other options, you can choose the width and height you want.",
"type": "string",
"enum": [
"2K",
"3K",
"2048x2048 (1:1)",
"2304x1728 (4:3)",
"1728x2304 (3:4)",
"2848x1600 (16:9)",
"1600x2848 (9:16)",
"2496x1664 (3:2)",
"1664x2496 (2:3)",
"3136x1344 (21:9)",
"3072x3072 (1:1)",
"3456x2592 (4:3)",
"2592x3456 (3:4)",
"4096x2304 (16:9)",
"2304x4096 (9:16)",
"3744x2496 (3:2)",
"2496x3744 (2:3)",
"4704x2016 (21:9)"
],
"default": "2304x1728 (4:3)"
},
"sequential_image_generation": {
"title": "Sequential Image Generation",
"description": "Enable this option to generate images sequentially.",
"type": "string",
"enum": [
"auto",
"disabled"
],
"default": "disabled"
},
"max_images": {
"title": "Max Images",
"description": "The maximum number of images to generate. Only effective when sequential_image_generation is set to auto.",
"type": "integer",
"enum": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
],
"default": 15
},
"output_format": {
"title": "Output Format",
"description": "The format of the output images. This will determine the format of the output images.",
"type": "string",
"enum": [
"png",
"jpeg"
],
"default": "png"
},
"optimize_prompt_options": {
"title": "Prompt Optimization",
"description": "Set the mode for the prompt optimization feature. standard: Higher quality, longer generation time. fast: Faster but at a more average quality.",
"type": "string",
"enum": [
"standard",
"fast"
],
"default": "standard"
}
}
}Output schema
{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "single image URL"
},
"video": {
"type": "string",
"format": "uri",
"description": "single video URL"
},
"images": {
"type": "array",
"description": "multiple image URLs",
"items": { "type": "string", "format": "uri" }
},
"videos": {
"type": "array",
"description": "multiple video URLs",
"items": { "type": "string", "format": "uri" }
}
}
}
}RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.
