text-to-image

Flux Kontext Pro - Create image from text

Generate images using FLUX Kontext Pro, an advanced text-to-image model with optional image input support.

This model excels at understanding context and generating high-quality images from text descriptions. Optionally, you can provide an input image to guide the generation process.

post/v1/ai/text-to-image/flux-kontext-pro

Request

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

Request body

promptstring required

Text description of the image you want to generate.

FLUX Kontext Pro is an advanced text-to-image model that excels at understanding context and generating high-quality images. It supports optional image input to guide the generation.

Tips for better results:

  • Be specific about subjects, scenes, and visual details
  • Describe lighting, atmosphere, and mood
  • Mention art style or photographic techniques if desired
input_imagestring uri nullable

Optional URL to an input image that will guide the generation process. The model will use this image as a reference while generating the output.

prompt_upsamplingboolean

Whether to perform upsampling on the prompt. If active, automatically modifies the prompt for more creative generation.

seedinteger nullable

Optional seed for reproducibility. If not provided, a random seed will be used.

guidancenumber nullable

Guidance scale for the generation. Higher values make the model follow the prompt more closely.

stepsinteger nullable

Number of inference steps. More steps generally produce higher quality but take longer.

aspect_ratio'square_1_1' | 'classic_4_3' | 'traditional_3_4' | 'widescreen_16_9' | 'social_story_9_16' | 'standard_3_2' | 'portrait_2_3' | 'horizontal_2_1' | 'vertical_1_2' | 'social_post_4_5'

Image size with the aspect ratio. The aspect ratio is the proportional relationship between an image's width and height, expressed as *_width_height (e.g., square_1_1, widescreen_16_9). It is calculated by dividing the width by the height.
If not present, the default is square_1_1.

safety_toleranceinteger

Tolerance level for input and output moderation. Between 0 and 6, 0 being most strict, 6 being least strict.

output_format'jpeg' | 'png' nullable

Format of the output image

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.

Example request

{
  "prompt": "a beautiful sunset over the ocean with dramatic clouds",
  "input_image": "https://example.com/reference-image.jpg",
  "aspect_ratio": "square_1_1",
  "webhook_url": "https://www.example.com/webhook"
}

Response

OK - Task created successfully

Example response

{
  "data": {
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Changes

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