> ## 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. # 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. ## OpenAPI ````yaml post /v1/ai/text-to-image/flux-kontext-pro openapi: 3.0.0 info: description: >- The Magnific API is your gateway to a vast collection of high-quality digital resources for your applications and projects. As a leading platform, it offers a wide range of graphics, including vectors, photos, illustrations, icons, PSD templates, and more, all curated by talented designers from around the world. title: Magnific API version: 1.0.0 servers: - description: B2B API Production V1 url: https://api.magnific.com security: - magnificApiKey: [] paths: /v1/ai/text-to-image/flux-kontext-pro: post: tags: - text-to-image summary: Flux Kontext Pro - Create image from text description: > 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. operationId: create_image_from_text_flux_kontext_pro requestBody: content: application/json: schema: $ref: '#/components/schemas/ttifkp-request-content' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/create_image_from_text_flux_200_response' description: OK - Task created successfully '400': content: application/json: examples: invalid_page: summary: Parameter 'page' is not valid value: message: Parameter 'page' must be greater than 0 invalid_query: summary: Parameter 'query' is not valid value: message: Parameter 'query' must not be empty invalid_filter: summary: Parameter 'filter' is not valid value: message: Parameter 'filter' is not valid generic_bad_request: summary: Bad Request value: message: Parameter ':attribute' is not valid schema: $ref: '#/components/schemas/get_all_style_transfer_tasks_400_response' application/problem+json: examples: invalid_page: summary: Parameter 'page' is not valid value: message: Validation error invalid_params: - field: page reason: Parameter 'page' must be greater than 0 - field: per_page reason: Parameter 'per_page' must be greater than 0 schema: $ref: >- #/components/schemas/get_all_style_transfer_tasks_400_response_1 description: >- Bad Request - The server could not understand the request due to invalid syntax. '401': content: application/json: examples: invalid_api_key: summary: API key is not valid value: message: Invalid API key missing_api_key: summary: API key is not provided value: message: Missing API key schema: $ref: '#/components/schemas/get_all_style_transfer_tasks_400_response' description: >- Unauthorized - The client must authenticate itself to get the requested response. '500': content: application/json: schema: $ref: '#/components/schemas/get_all_style_transfer_tasks_500_response' description: >- Internal Server Error - The server has encountered a situation it doesn't know how to handle. '503': content: application/json: schema: $ref: '#/components/schemas/get_all_style_transfer_tasks_503_response' description: Service Unavailable components: schemas: ttifkp-request-content: properties: prompt: description: > 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 example: a beautiful sunset over the ocean with dramatic clouds type: string input_image: description: > 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. example: https://example.com/reference-image.jpg format: uri nullable: true type: string prompt_upsampling: default: false description: >- Whether to perform upsampling on the prompt. If active, automatically modifies the prompt for more creative generation. type: boolean seed: description: >- Optional seed for reproducibility. If not provided, a random seed will be used. nullable: true type: integer guidance: default: 3 description: >- Guidance scale for the generation. Higher values make the model follow the prompt more closely. maximum: 10 minimum: 1 nullable: true type: number steps: default: 50 description: >- Number of inference steps. More steps generally produce higher quality but take longer. maximum: 100 minimum: 1 nullable: true type: integer aspect_ratio: default: square_1_1 description: > 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`. enum: - 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 example: square_1_1 type: string safety_tolerance: default: 2 description: >- Tolerance level for input and output moderation. Between 0 and 6, 0 being most strict, 6 being least strict. maximum: 6 minimum: 0 type: integer output_format: description: Format of the output image enum: - jpeg - png nullable: true type: string webhook_url: description: > 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: https://www.example.com/webhook format: uri type: string required: - prompt type: object create_image_from_text_flux_200_response: example: data: task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: CREATED properties: data: $ref: '#/components/schemas/task' required: - data type: object get_all_style_transfer_tasks_400_response: example: message: message properties: message: type: string type: object get_all_style_transfer_tasks_400_response_1: properties: problem: $ref: >- #/components/schemas/get_all_style_transfer_tasks_400_response_1_problem type: object get_all_style_transfer_tasks_500_response: example: message: Internal Server Error properties: message: example: Internal Server Error type: string type: object get_all_style_transfer_tasks_503_response: example: message: Service Unavailable. Please try again later. properties: message: example: Service Unavailable. Please try again later. type: string type: object task: example: task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: CREATED properties: task_id: description: Task identifier format: uuid type: string status: description: Task status enum: - CREATED - IN_PROGRESS - COMPLETED - FAILED type: string required: - status - task_id type: object get_all_style_transfer_tasks_400_response_1_problem: properties: message: example: Validation error type: string invalid_params: items: $ref: >- #/components/schemas/get_all_style_transfer_tasks_400_response_1_problem_invalid_params_inner type: array required: - invalid_params - message type: object get_all_style_transfer_tasks_400_response_1_problem_invalid_params_inner: properties: name: description: Name of the invalid parameter. example: page type: string field: description: Field of the invalid parameter. Mirrors `name`. example: page type: string reason: example: Parameter 'page' must be greater than 0 type: string required: - field - name - reason type: object securitySchemes: magnificApiKey: description: > Your Magnific API key. Required for authentication. [Learn how to obtain an API key](https://docs.magnific.com/quickstart) in: header name: x-magnific-api-key type: apiKey ````