text-to-image

Seedream V5 Lite - Edit image

Edit images using ByteDance's Seedream V5 Lite model with text guidance.

Key Features:

  • Preserves subject details, lighting, and color tone
  • Supports up to 5 reference images
  • Enhanced editing consistency
  • Up to 4MP output resolution

Best for:

  • Image-to-image editing
  • Style transfer with consistency
  • Multi-image reference editing
post/v1/ai/text-to-image/seedream-v5-lite-edit

Request

  • Base URL: https://api.magnific.com
  • URL: https://api.magnific.com/v1/ai/text-to-image/seedream-v5-lite-edit
  • 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 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_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.

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
seedinteger

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_checkerboolean

Whether to enable the content safety checker. When enabled, the model filters potentially unsafe content.

reference_imagesstring[] required

Array of reference images for image editing. Seedream V5 Lite preserves subject details, lighting, and color tone when editing.

Supported formats:

  • Base64-encoded image strings
  • Publicly accessible image URLs

Image requirements:

  • Minimum resolution: 256x256 pixels
  • Maximum file size: 10MB per image
  • Supported formats: JPG, JPEG, PNG

Example request

{
  "prompt": "A futuristic cityscape at sunset with neon lights",
  "webhook_url": "https://www.example.com/webhook",
  "aspect_ratio": "square_1_1",
  "seed": 12345,
  "reference_images": [
    "https://example.com/reference-image-1.jpg",
    "https://example.com/reference-image-2.jpg"
  ]
}

Response

OK - The request has succeeded and the Seedream V5 Lite edit 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.