← Back to Models

bytedance/seedream-4

Seedream 4 image generation with optional multi-image input and sequential generation.

image text-to-image

Pricing

Base: 3 credits per image

Adjustments:

size multiplier:
1K: 0.75x
2K: 1x
4K: 2x
custom: 1.5x

Example Pricing:

Base request: 4 credits
Size: 1K: 3 credits
Size: 2K: 4 credits
Size: 4K: 8 credits
Size: custom: 6 credits
Range: 5 - 9 credits

Input Parameters

size string

Image resolution: 1K (1024px), 2K (2048px), 4K (4096px), or 'custom' for specific dimensions.

Default: 2K

Options: 1K, 2K, 4K, custom

Width integer

Custom image width (only used when size='custom'). Range: 1024-4096 pixels.

Default: 2048

Height integer

Custom image height (only used when size='custom'). Range: 1024-4096 pixels.

Default: 2048

Prompt required string

Text prompt for image generation

Max Images integer

Maximum number of images to generate when sequential_image_generation='auto'. Range: 1-15. Total images (input + generated) cannot exceed 15.

Default: 1

Image Input array

Input image(s) for image-to-image generation. List of 1-10 images for single or multi-reference generation.

Default: []

aspect_ratio string

Image aspect ratio. Only used when size is not 'custom'. Use 'match_input_image' to automatically match the input image's aspect ratio.

Default: match_input_image

Options: match_input_image, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9

sequential_image_generation string

Group image generation mode. 'disabled' generates a single image. 'auto' lets the model decide whether to generate multiple related images (e.g., story scenes, character variations).

Default: disabled

Options: disabled, auto

Directives

Advanced Keys:
max_images sequential_image_generation width height
Hidden Keys:
max_images
Raw JSON
{
    "identifier": "bytedance/seedream-4",
    "type": "image",
    "updated_at": "2025-10-08T00:00:00Z",
    "category": "text-to-image",
    "description": "Seedream 4 image generation with optional multi-image input and sequential generation.",
    "pricing": {
        "version": 1,
        "base": {
            "unit": "image",
            "credits": 3
        },
        "adjustments": [
            {
                "type": "multiplier_map",
                "key": "size",
                "map": {
                    "1K": 0.75,
                    "2K": 1,
                    "4K": 2,
                    "custom": 1.5
                },
                "default": 1
            }
        ],
        "display": {
            "min_credits": 5,
            "max_credits": 9
        }
    },
    "directives": {
        "advancedKeys": [
            "max_images",
            "sequential_image_generation",
            "width",
            "height"
        ],
        "hiddenKeys": [
            "max_images"
        ],
        "inputTransforms": [],
        "imageArrayKeys": [
            "image_input"
        ]
    },
    "inputSchema": {
        "type": "object",
        "title": "Input",
        "required": [
            "prompt"
        ],
        "properties": {
            "size": {
                "enum": [
                    "1K",
                    "2K",
                    "4K",
                    "custom"
                ],
                "type": "string",
                "title": "size",
                "description": "Image resolution: 1K (1024px), 2K (2048px), 4K (4096px), or 'custom' for specific dimensions.",
                "default": "2K",
                "x-order": 2
            },
            "width": {
                "type": "integer",
                "title": "Width",
                "default": 2048,
                "maximum": 4096,
                "minimum": 1024,
                "x-order": 4,
                "description": "Custom image width (only used when size='custom'). Range: 1024-4096 pixels."
            },
            "height": {
                "type": "integer",
                "title": "Height",
                "default": 2048,
                "maximum": 4096,
                "minimum": 1024,
                "x-order": 5,
                "description": "Custom image height (only used when size='custom'). Range: 1024-4096 pixels."
            },
            "prompt": {
                "type": "string",
                "title": "Prompt",
                "x-order": 0,
                "description": "Text prompt for image generation"
            },
            "max_images": {
                "type": "integer",
                "title": "Max Images",
                "default": 1,
                "maximum": 15,
                "minimum": 1,
                "x-order": 7,
                "description": "Maximum number of images to generate when sequential_image_generation='auto'. Range: 1-15. Total images (input + generated) cannot exceed 15."
            },
            "image_input": {
                "type": "array",
                "items": {
                    "type": "string",
                    "format": "uri"
                },
                "title": "Image Input",
                "default": [],
                "x-order": 1,
                "description": "Input image(s) for image-to-image generation. List of 1-10 images for single or multi-reference generation."
            },
            "aspect_ratio": {
                "enum": [
                    "match_input_image",
                    "1:1",
                    "4:3",
                    "3:4",
                    "16:9",
                    "9:16",
                    "3:2",
                    "2:3",
                    "21:9"
                ],
                "type": "string",
                "title": "aspect_ratio",
                "description": "Image aspect ratio. Only used when size is not 'custom'. Use 'match_input_image' to automatically match the input image's aspect ratio.",
                "default": "match_input_image",
                "x-order": 3
            },
            "sequential_image_generation": {
                "enum": [
                    "disabled",
                    "auto"
                ],
                "type": "string",
                "title": "sequential_image_generation",
                "description": "Group image generation mode. 'disabled' generates a single image. 'auto' lets the model decide whether to generate multiple related images (e.g., story scenes, character variations).",
                "default": "disabled",
                "x-order": 6
            }
        }
    },
    "outputSchema": {
        "type": "string",
        "title": "Output",
        "format": "uri"
    }
}