---
title: "Seedream V5 Lite - Create image from text"
method: POST
path: "/v1/ai/text-to-image/seedream-v5-lite"
tags: ["text-to-image"]
---

# Seedream V5 Lite - Create image from text

`POST /v1/ai/text-to-image/seedream-v5-lite`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/text-to-image/seedream-v5-lite`
- Auth: API key in header `x-magnific-api-key`

Generate high-quality images from text descriptions using ByteDance's Seedream V5 Lite model.

**Key Features:**
- Improved detail and composition over previous versions
- Up to 4MP resolution support
- Various aspect ratios available
- Optional seed for reproducibility

**Best for:**
- High-quality image generation
- Detailed scenes and compositions
- Cinematic and artistic imagery

## Request body

- Ttisdv5lRequestContent
  - `prompt` string, required: Text description of the image you want to generate. **Tips:** - Be specific about visual details, composition, and style - Seedream V5 Lite excels at high-quality image generation with improved detail and composition - Describe lighting, atmosphere, and camera angles for best results **Examples:** - Simple: "A futuristic cityscape at sunset with neon lights" - Detailed: "A futuristic cityscape at sunset with neon lights, detailed architecture, volumetric lighting, cinematic composition"
  - `webhook_url` string, uri: Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.
  - `aspect_ratio` 'square_1_1' | 'widescreen_16_9' | 'social_story_9_16' | 'portrait_2_3' | 'traditional_3_4' | 'standard_3_2' | 'classic_4_3' | 'cinematic_21_9': The aspect ratio of the generated image. Seedream V5 Lite supports up to 4MP resolution. Available options: - `square_1_1`: Square format (2048x2048) - Instagram feed, profile pictures - `widescreen_16_9`: Landscape (2730x1536) - YouTube thumbnails, presentations - `social_story_9_16`: Portrait (1536x2730) - TikTok, Instagram Stories - `portrait_2_3`: Tall portrait (1672x2508) - Pinterest pins - `traditional_3_4`: Classic photo (1774x2364) - Traditional photography - `standard_3_2`: Photo print (2508x1672) - Standard prints - `classic_4_3`: Monitor ratio (2364x1774) - Classic displays - `cinematic_21_9`: Ultra-wide (3062x1312) - Cinematic banners
  - `seed` integer: Random seed for reproducibility. Using the same seed with identical parameters produces similar results. Useful for iterating on a design or creating variations.
  - `enable_safety_checker` boolean: Whether to enable the content safety checker. When enabled, the model filters potentially unsafe content.

## Response `200`

OK - The request has succeeded and the Seedream V5 Lite process has started.

- GetStyleTransferTaskStatus200Response
  - `data` TaskDetail, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status
    - `generated` string[], required

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)