text-to-image

Seedream 5.0 Pro - Create image from text

Generate high-quality images from text descriptions using ByteDance's Seedream 5.0 Pro model.

Key Features:

  • Flagship image quality with high-fidelity detail
  • Strong prompt adherence and superior composition
  • Selectable resolution tiers (1.5K, 2K)
  • Various aspect ratios available
  • Optional seed for reproducibility

Best for:

  • Professional and large-format imagery
  • Detailed scenes and complex compositions
  • Cinematic and artistic visuals
post/v1/ai/text-to-image/seedream-v5-pro

Request

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

Request body

promptstring required

Text description of the image you want to generate.

Tips:

  • Be specific about visual details, composition, and style
  • Seedream 5.0 Pro delivers high-fidelity detail, strong prompt adherence, and superior 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_urlstring 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.

resolution'1.5k' | '2k'

Output resolution tier.

Available options:

  • 2k: Base output - up to ~4.19M pixels (2048x2048 at 1:1)
  • 1.5k: Economical tier - capped at ~2.36M pixels (1536x1536 at 1:1)

The final image dimensions fit the selected aspect ratio within the tier's pixel budget, with each dimension rounded to a multiple of 16.

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, combined with the resolution tier to compute the final dimensions.

Available options:

  • square_1_1: Square format - Instagram feed, profile pictures
  • widescreen_16_9: Landscape - YouTube thumbnails, presentations
  • social_story_9_16: Portrait - TikTok, Instagram Stories
  • portrait_2_3: Tall portrait - Pinterest pins
  • traditional_3_4: Classic photo - Traditional photography
  • standard_3_2: Photo print - Standard prints
  • classic_4_3: Monitor ratio - Classic displays
  • cinematic_21_9: Ultra-wide - Cinematic banners
seedinteger

Random seed for reproducibility. Using the same seed with identical parameters produces similar results. Useful for iterating on a design or creating variations.

Example request

{
  "prompt": "A futuristic cityscape at sunset with neon lights",
  "webhook_url": "https://www.example.com/webhook",
  "resolution": "2k",
  "aspect_ratio": "square_1_1",
  "seed": 12345
}

Response

OK - The request has succeeded and the Seedream 5.0 Pro process has started.

Example response

{
  "data": {
    "generated": [
      "https://openapi-generator.tech",
      "https://openapi-generator.tech"
    ],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.