> ## 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 Text to Image > Generate image sets with Seedream 4, with output up to 4K for illustrations, design concepts, and visual variations. 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 Text to Image Generate image sets with Seedream 4, with output up to 4K for illustrations, design concepts, and visual variations. ## Available Models * **bytedance/seedream/v4/text-to-image** - Generate images from text prompts. ## Output Options ### Image Size * `size`: Optional. Accepted values: `1:1`, `3:4`, `4:3`, `16:9`, `9:16`, `3:2`, `2:3`, `21:9`. Default: `1:1`. ### Resolution * `resolution`: Optional. Accepted values: `1K`, `2K`, `4K`. Default: `2K`. ### Image Count * `n`: Optional. Number of images to generate. Integer from `1` to `15`. Default: `1`. ## Key Features * Generate images from text prompts. * Choose from `1K`, `2K`, `4K` output resolutions. * 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-5,000 characters**. * Include at least one non-whitespace character. ## OpenAPI ````yaml api-manual/image-series/bytedance-seedream-v4-text-to-image.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - Seedream 4 Text to Image description: >- Generate image sets with Seedream 4, with output up to 4K for illustrations, design concepts, and visual variations. version: 1.0.0 servers: - url: https://api.vidgo.ai security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - Image Series summary: Seedream 4 Text to Image description: >- Submit an asynchronous text-to-image task. Provide a prompt containing 1–5,000 characters with at least one non-whitespace character. operationId: submit_bytedance_seedream_v4_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/text-to-image enum: - bytedance/seedream/v4/text-to-image input: type: object required: - prompt properties: prompt: type: string maxLength: 5000 minLength: 1 description: >- Describe the desired image using 1–5,000 characters, including at least one non-whitespace character. size: type: string enum: - '1:1' - '3:4' - '4:3' - '16:9' - '9:16' - '3:2' - '2:3' - '21:9' default: '1:1' description: >- Output aspect ratio: 1:1, 3:4, 4:3, 16:9, 9:16, 3:2, 2:3, or 21:9. Default: 1:1. resolution: type: string enum: - 1K - 2K - 4K default: 2K description: 'Output resolution preset: 1K, 2K, or 4K. Default: 2K.' 'n': type: integer minimum: 1 maximum: 15 default: 1 description: 'Number of images to generate, from 1 to 15. Default: 1.' 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: text-to-image-02: summary: Steam Hour at Tbilisi Baths value: model: bytedance/seedream/v4/text-to-image input: prompt: >- A cinematic documentary photograph inside a historic sulfur bath house in the Abanotubani district of Tbilisi, Georgia, mid-afternoon. In the foreground, an older Georgian attendant in a white cotton wrap and rubber sandals kneels at the rim of a hexagonal stone pool, testing the water with the back of his hand; steam wraps around his forearm. In the middle ground, a younger woman sits on a marble bench with a folded striped towel over her shoulders, her face half-hidden by a drifting steam veil, talking to a friend who is only visible as a silhouette behind a brick arch. In the far background, a high oculus window drops a single hard shaft of daylight onto the wet brick floor, making the steam glow. Correct occlusion between the three figures, every highlight coming from that one oculus, wet stone texture, visible condensation on the brick vault, 35mm lens, natural skin texture, believable hands with five fingers, no text, no logos, no watermark. size: '3:2' resolution: 2K 'n': 1 text-to-image-01: summary: How a Qanat Shares Water value: model: bytedance/seedream/v4/text-to-image input: prompt: >- A scientifically accurate educational infographic of a Persian qanat on cream paper, warm naturalist watercolor linework. Title across the top is only the Chinese phrase printed exactly 坎儿井如何分水. Four panels in a 2x2 grid. Panel 1 caption is the single English word WELL under the Chinese 母井: a gravel mound with a vertical well, a blue dashed water table, and a hanging bucket. Panel 2 caption is the single English word TUNNEL under the Chinese 暗渠: a downhill tunnel with a 1 percent slope and left-to-right flow arrows. Panel 3 caption is the single English word SHAFTS under the Chinese 竖井: four evenly spaced vertical shafts. Panel 4 caption is the single English word OUTLET under the Chinese 龙口: the tunnel emerges at an oasis and splits into two channels labeled with the single words LEFT and RIGHT under 左渠 and 右渠. Use only these English words: WELL, TUNNEL, SHAFTS, OUTLET, LEFT, RIGHT. Each English word stands alone with space around it. Do not add extra letters. Consistent water table and downhill slope. No other text, no watermark. size: '4:3' resolution: 4K 'n': 1 text-to-image-03: summary: Salt Harvest on Lake Abbe value: model: bytedance/seedream/v4/text-to-image input: prompt: >- An ultra-wide cinematic landscape photograph of Lake Abbe on the Ethiopia–Djibouti border at first light. In the left third of the foreground, two Afar salt workers in faded cotton wraps and sandals stand beside a low wooden sledge piled with pale salt cakes; one man lifts a slab while the other steadies a long wooden pole. Mid-frame, a shallow pink-white salt crust stretches toward the lake, with a few flamingos standing in a thin sheet of water. On the right, a row of tall pale limestone chimneys rises from the flats, their bases still in blue shadow while their tops catch the first gold sun. Far behind, a hazy volcanic ridge sits under a clear pale sky. Correct relative scale between the workers, the flamingos, the chimneys and the distant ridge, one consistent low sun from the right, fine crystal texture on the salt, visible breath in the cool air, no text, no watermark. size: '21:9' resolution: 2K 'n': 1 callback: summary: Receive a completion callback value: model: bytedance/seedream/v4/text-to-image input: prompt: >- A cinematic documentary photograph inside a historic sulfur bath house in the Abanotubani district of Tbilisi, Georgia, mid-afternoon. In the foreground, an older Georgian attendant in a white cotton wrap and rubber sandals kneels at the rim of a hexagonal stone pool, testing the water with the back of his hand; steam wraps around his forearm. In the middle ground, a younger woman sits on a marble bench with a folded striped towel over her shoulders, her face half-hidden by a drifting steam veil, talking to a friend who is only visible as a silhouette behind a brick arch. In the far background, a high oculus window drops a single hard shaft of daylight onto the wet brick floor, making the steam glow. Correct occlusion between the three figures, every highlight coming from that one oculus, wet stone texture, visible condensation on the brick vault, 35mm lens, natural skin texture, believable hands with five fingers, no text, no logos, no watermark. size: '3:2' resolution: 2K 'n': 1 callback_url: https://your-domain.com/callback 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: KM1JC58S12F3BATH status: running created_time: '2026-09-26T10:59:51' '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. ````