> ## Documentation Index > Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Seedream 4.5 Text to Image > Develop visual concepts with Seedream 4.5, generating multiple images from a prompt to explore different styles and compositions. 1. Submit the request with `VIDGO_API_KEY`. A `task_id` is returned immediately. Keep it until the task reaches `finished` or `failed`. 2. Use [Query Task Status](/api-manual/task-management/status) to retrieve the result. If you provide a `callback_url`, Vidgo sends the result to your [webhook](/api-manual/task-management/webhooks) when the task finishes or fails. # Seedream 4.5 Text to Image Develop visual concepts with Seedream 4.5, generating multiple images from a prompt to explore different styles and compositions. ## Available Models * **bytedance/seedream/v4.5/text-to-image** - Generate images from text prompts. ## Output Options ### Image Size * `size`: Optional. Default: `1:1`. * Presets: `2K`, `4K`, `1:1`, `4:3`, `3:4`, `16:9`, `9:16`, `3:2`, `2:3`, `21:9`. * For custom dimensions, supply an object with integer `width` and `height`; both must be positive. * Custom dimensions also accept a `WIDTHxHEIGHT` string, using `x` or `X` between the positive dimensions. ### Image Count * `n`: Optional. Number of images to generate. Integer from `1` to `15`. Default: `1`. ## Key Features * Generate images from text prompts. * Control the number of output images with `n`. ## Advanced Parameters Set `model` and optional `callback_url` at the request root. Place all workflow parameters, including output options, inside `input`. ### Prompt * `prompt`: Required. Describe the desired image. Length: **1-3,000 characters**. * Include at least one non-whitespace character. ### Safety Checker * `enable_safety_checker`: Optional. Set `true` to enable the content safety check or `false` to disable it. Default: `true`. ## Verified Example This example was generated through the Vidgo test API with the `basic` request shown in the API playground. The result image is hosted on the Vidgo CDN. ![Aurora Ridge Station Cutaway](https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4.5/text-to-image/v1/01/output.jpg) ```json theme={null} { "code": 200, "data": { "task_id": "PGQCZ3X31DC6OEXQ", "status": "finished", "files": [ { "file_url": "https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4.5/text-to-image/v1/01/output.jpg", "file_type": "image" } ], "created_time": "2026-09-25T16:14:03", "error_message": null, "progress": 100 } } ``` ## OpenAPI ````yaml api-manual/image-series/bytedance-seedream-v4-5-text-to-image.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - Seedream 4.5 Text to Image description: >- Develop visual concepts with Seedream 4.5, generating multiple images from a prompt to explore different styles and compositions. version: 1.0.0 servers: - url: https://api.vidgo.ai security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - Image Series summary: Seedream 4.5 Text to Image description: >- Submit an asynchronous image generation task. Provide a prompt containing 1–3,000 characters. Custom size width and height are positive integers. operationId: submit_bytedance_seedream_v4_5_text_to_image requestBody: required: true content: application/json: schema: type: object required: - model - input additionalProperties: true properties: model: type: string example: bytedance/seedream/v4.5/text-to-image enum: - bytedance/seedream/v4.5/text-to-image input: type: object required: - prompt properties: prompt: type: string maxLength: 3000 minLength: 1 description: >- Describe the desired image using 1–3,000 characters, including at least one non-whitespace character. size: oneOf: - type: string pattern: >- ^(?:2K|4K|1:1|4:3|3:4|16:9|9:16|3:2|2:3|21:9|(?:\s*\d+\s*[xX]\s*\d+\s*))$ description: >- Use a preset (`2K`, `4K`, `1:1`, `4:3`, `3:4`, `16:9`, `9:16`, `3:2`, `2:3`, `21:9`) or custom `WIDTHxHEIGHT` dimensions. title: Size string - type: object required: - width - height properties: width: type: integer description: Output width in pixels; a positive integer. minimum: 1 height: type: integer description: Output height in pixels; a positive integer. minimum: 1 additionalProperties: false description: >- Custom dimensions as an object with positive integer width and height. title: Width and height default: '1:1' description: >- Output size: 2K, 4K, a ratio preset, a WIDTHxHEIGHT string, or an object with positive integer width and height. Default: 1:1. 'n': type: integer minimum: 1 maximum: 15 default: 1 description: 'Number of images to generate, from 1 to 15. Default: 1.' enable_safety_checker: type: boolean default: true description: >- Set true to enable safety checking or false to disable it. Default: true. additionalProperties: false callback_url: type: string nullable: true description: >- Optional public HTTP(S) URL for task completion notifications. description: >- Set model and optional callback_url at the request root. Place generation parameters inside input. examples: basic: summary: 'Verified default: Aurora Ridge Station Cutaway' value: model: bytedance/seedream/v4.5/text-to-image input: prompt: >- A detailed isometric cutaway illustration of a small polar research station standing on steel stilts on an Antarctic ice shelf, shown like a page from a science museum guidebook. The roof and front wall are removed so six rooms are visible, each with a small clean sans-serif label plate printed exactly: "LAB" (a scientist examining an ice core under a lamp), "GALLEY" (two people cooking soup at a steaming stove), "BUNKS" (stacked beds with colorful quilts), "RADIO" (an operator with headphones in front of dials), "GREENHOUSE" (lettuce and tomatoes under pink grow lights) and "GARAGE" (an orange snowcat being repaired). A banner across the top reads exactly "AURORA RIDGE STATION", and a small thermometer sign beside the entrance reads "-38°C". Tiny figures, pipes, ladders and cables connect the rooms logically. Outside: blowing snow, a weather mast, a pale green aurora in the dark sky. Crisp linework, soft flat colors, consistent isometric perspective, every label spelled correctly and legible, no extra text, no watermark. size: '4:3' 'n': 1 enable_safety_checker: true verified-2: summary: 'Verified example: Net Mender in the Monsoon' value: model: bytedance/seedream/v4.5/text-to-image input: prompt: >- A vertical documentary portrait photograph of an elderly South Indian fisherwoman mending a fishing net under the palm-thatched roof of a wooden pier in Kerala during a monsoon evening. She sits cross-legged, wearing a faded turquoise cotton sari with a thin gold border and a small silver nose stud; her deeply lined face, silver hair tied back and weathered hands pulling green nylon mesh are in sharp focus. Blue-hour light from the backwaters mixes with the warm glow of a single hanging kerosene lantern beside her. Heavy rain falls in streaks beyond the roof edge, drops glint on the net, wet planks reflect the lantern, and a few moored wooden boats fade into the misty background. Natural skin texture with pores and fine wrinkles, calm dignified expression looking at her work, 85mm lens, shallow depth of field, believable hands with five fingers, no text, no watermark. size: '3:4' 'n': 1 enable_safety_checker: true verified-3: summary: 'Verified example: Inside the Rotating Habitat' value: model: bytedance/seedream/v4.5/text-to-image input: prompt: >- An ultra-wide cinematic panorama from inside a gigantic rotating cylindrical space habitat. The camera stands on a gravel path in the foreground among ripening wheat and small orchards; the farmland, rivers, winding roads and small white villages continuously curve upward on both sides and arc overhead, so the opposite side of the cylinder is visible high in the sky, upside down, with tiny fields and lakes. A long glowing sun-line runs along the central axis, casting soft morning light and thin wispy clouds drifting in the middle of the cylinder. At the far end, a huge circular end-cap window shows black space, stars and a slice of a blue planet. A cyclist rides along the path for scale. Coherent curved perspective, consistent lighting, atmospheric haze with distance, grounded realistic sci-fi concept art with photographic detail, no text, no logos, no watermark. size: '21:9' 'n': 1 enable_safety_checker: true callback: summary: Receive a completion callback value: model: bytedance/seedream/v4.5/text-to-image input: prompt: >- A detailed isometric cutaway illustration of a small polar research station standing on steel stilts on an Antarctic ice shelf, shown like a page from a science museum guidebook. The roof and front wall are removed so six rooms are visible, each with a small clean sans-serif label plate printed exactly: "LAB" (a scientist examining an ice core under a lamp), "GALLEY" (two people cooking soup at a steaming stove), "BUNKS" (stacked beds with colorful quilts), "RADIO" (an operator with headphones in front of dials), "GREENHOUSE" (lettuce and tomatoes under pink grow lights) and "GARAGE" (an orange snowcat being repaired). A banner across the top reads exactly "AURORA RIDGE STATION", and a small thermometer sign beside the entrance reads "-38°C". Tiny figures, pipes, ladders and cables connect the rooms logically. Outside: blowing snow, a weather mast, a pale green aurora in the dark sky. Crisp linework, soft flat colors, consistent isometric perspective, every label spelled correctly and legible, no extra text, no watermark. size: '4:3' 'n': 1 enable_safety_checker: true callback_url: https://your-domain.com/callback custom-string: summary: Custom size string value: model: bytedance/seedream/v4.5/text-to-image input: prompt: >- A detailed isometric cutaway illustration of a small polar research station standing on steel stilts on an Antarctic ice shelf, shown like a page from a science museum guidebook. The roof and front wall are removed so six rooms are visible, each with a small clean sans-serif label plate printed exactly: "LAB" (a scientist examining an ice core under a lamp), "GALLEY" (two people cooking soup at a steaming stove), "BUNKS" (stacked beds with colorful quilts), "RADIO" (an operator with headphones in front of dials), "GREENHOUSE" (lettuce and tomatoes under pink grow lights) and "GARAGE" (an orange snowcat being repaired). A banner across the top reads exactly "AURORA RIDGE STATION", and a small thermometer sign beside the entrance reads "-38°C". Tiny figures, pipes, ladders and cables connect the rooms logically. Outside: blowing snow, a weather mast, a pale green aurora in the dark sky. Crisp linework, soft flat colors, consistent isometric perspective, every label spelled correctly and legible, no extra text, no watermark. size: 1920x4096 'n': 1 enable_safety_checker: true custom-object: summary: Custom size object value: model: bytedance/seedream/v4.5/text-to-image input: prompt: >- A detailed isometric cutaway illustration of a small polar research station standing on steel stilts on an Antarctic ice shelf, shown like a page from a science museum guidebook. The roof and front wall are removed so six rooms are visible, each with a small clean sans-serif label plate printed exactly: "LAB" (a scientist examining an ice core under a lamp), "GALLEY" (two people cooking soup at a steaming stove), "BUNKS" (stacked beds with colorful quilts), "RADIO" (an operator with headphones in front of dials), "GREENHOUSE" (lettuce and tomatoes under pink grow lights) and "GARAGE" (an orange snowcat being repaired). A banner across the top reads exactly "AURORA RIDGE STATION", and a small thermometer sign beside the entrance reads "-38°C". Tiny figures, pipes, ladders and cables connect the rooms logically. Outside: blowing snow, a weather mast, a pale green aurora in the dark sky. Crisp linework, soft flat colors, consistent isometric perspective, every label spelled correctly and legible, no extra text, no watermark. size: width: 2304 height: 3072 'n': 1 enable_safety_checker: true responses: '200': description: Task submitted content: application/json: schema: type: object required: - code - data properties: code: type: integer enum: - 200 data: type: object required: - task_id - status - created_time properties: task_id: type: string status: type: string enum: - not_started - running - finished - failed created_time: type: string format: date-time example: code: 200 data: task_id: PGQCZ3X31DC6OEXQ status: running created_time: '2026-09-25T16:14:03' '400': description: Request validation or account balance error content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '401': description: Authentication error content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '403': description: Access denied content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '404': description: Unknown or disabled model content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '408': description: Request timed out content: text/plain: schema: type: string example: Request timeout '422': description: Invalid JSON or non-object request body content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '429': description: Request rate or account limit reached content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '500': description: Internal server error content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '502': description: Task creation error content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '503': description: Service temporarily unavailable content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} components: securitySchemes: BearerAuth: type: http scheme: bearer description: Use VIDGO_API_KEY. ````