> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magnific.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedream 4 - Text To Image API

> Next-generation text-to-image model for high-quality, consistent generations with flexible aspect ratios and production-ready outputs.

Seedream 4 is a text‑to‑image model focused on reliable, production‑ready outputs. It delivers high‑quality imagery from natural language prompts, with strong detail retention, coherent composition, and controllable styles across seven aspect ratios. Need precise instruction‑driven editing? Try <a href="/api-reference/text-to-image/seedream-4-edit/overview">Seedream 4 Edit</a>.

### Key capabilities

* **High‑quality generations** with strong subject and style consistency
* **Seven aspect ratios**: `square_1_1`, `widescreen_16_9`, `social_story_9_16`, `portrait_2_3`, `traditional_3_4`, `standard_3_2`, `classic_4_3`
* **Guidance scale control** (0–20, default 2.5) to tune prompt adherence vs. creative freedom
* **Reproducible outputs** via optional seed parameter (0–2,147,483,647)
* **Async workflow** with task polling and optional webhook notifications

### Use cases

* Product and lifestyle imagery for e‑commerce and marketing
* Concept art and visual ideation with consistent styles
* Editorial and social assets tailored to target aspect ratios
* Brand‑aligned visuals with coherent color and composition
* Automated content pipelines integrated via webhooks

### Generate images with Seedream 4

Create images by submitting a text prompt to the API. The service returns a task ID for async polling or webhook notification.

<div className="my-11">
  <Columns cols={2}>
    <Card title="POST /v1/ai/text-to-image/seedream-v4" icon="wand-magic-sparkles" href="/api-reference/text-to-image/seedream-4/post-seedream-v4">
      Create a Seedream 4 generation task
    </Card>

    <Card title="GET /v1/ai/text-to-image/seedream-v4/{task-id}" icon="magnifying-glass" href="/api-reference/text-to-image/seedream-4/get-seedream-v4-detail">
      Get task status and results by ID
    </Card>

    <Card title="GET /v1/ai/text-to-image/seedream-v4" icon="list" href="/api-reference/text-to-image/seedream-4/get-seedream-v4">
      List all Seedream 4 tasks
    </Card>
  </Columns>
</div>

### Parameters

| Parameter        | Type      | Required | Default      | Description                                                                                                                          |
| ---------------- | --------- | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| `prompt`         | `string`  | Yes      | —            | Text description of the image to generate                                                                                            |
| `aspect_ratio`   | `string`  | No       | `square_1_1` | Output ratio: `square_1_1`, `widescreen_16_9`, `social_story_9_16`, `portrait_2_3`, `traditional_3_4`, `standard_3_2`, `classic_4_3` |
| `guidance_scale` | `number`  | No       | `2.5`        | Controls prompt adherence (0–20). Higher values follow the prompt more closely                                                       |
| `seed`           | `integer` | No       | —            | Random seed for reproducible results (0–2,147,483,647)                                                                               |
| `webhook_url`    | `string`  | No       | —            | Callback URL for async task status notifications                                                                                     |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Seedream 4 and how does it work?">
    Seedream 4 is a text‑to‑image generation model. You submit a text prompt via the API, receive a task ID, and poll for results or receive a webhook notification when the image is ready.
  </Accordion>

  <Accordion title="What aspect ratios are supported?">
    Seedream 4 supports seven aspect ratios: `square_1_1`, `widescreen_16_9`, `social_story_9_16`, `portrait_2_3`, `traditional_3_4`, `standard_3_2`, and `classic_4_3`. The default is `square_1_1`.
  </Accordion>

  <Accordion title="How does guidance_scale affect the output?">
    The `guidance_scale` parameter (0–20, default 2.5) controls how closely the output follows the prompt. Higher values produce images that adhere more strictly to the text; lower values allow more creative freedom.
  </Accordion>

  <Accordion title="Are outputs suitable for production?">
    Yes. Seedream 4 targets production‑ready image quality and prompt reliability. For extreme resolutions, pair it with an upscaler.
  </Accordion>

  <Accordion title="What is the difference between Seedream 4 and Seedream 4 Edit?">
    Seedream 4 generates images from text prompts. <a href="/api-reference/text-to-image/seedream-4-edit/overview">Seedream 4 Edit</a> performs instruction‑driven editing on existing images, supporting addition, deletion, modification, and replacement operations with reference images.
  </Accordion>
</AccordionGroup>