# flux/dev/image-to-image {% columns %} {% column width="66.66666666666666%" %} {% hint style="info" %} This documentation is valid for the following list of our models: * `flux/dev/image-to-image` {% endhint %} {% endcolumn %} {% column width="33.33333333333334%" %} Try in Playground {% endcolumn %} {% endcolumns %} ## Model Overview A state-of-the-art image generation model that utilizes a 12 billion parameter rectified flow transformer architecture. It is designed to generate high-quality images from textual descriptions, making it a powerful tool for developers and creatives.
ModelGenerated image properties
flux/dev/image-to-imageFormat: PNG
Fixed size: Matches the dimensions of the reference image.
## Setup your API Key If you don’t have an API key for the AI/ML API yet, feel free to use our [Quickstart guide](https://docs.aimlapi.com/quickstart/setting-up). ## API Schema ## POST /v1/images/generations > ```json {"openapi":"3.0.0","info":{"title":"AIML API","version":"1.0.0"},"servers":[{"url":"https://api.aimlapi.com"}],"paths":{"/v1/images/generations":{"post":{"operationId":"_v1_images_generations","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","enum":["flux/dev/image-to-image"]},"prompt":{"type":"string","maxLength":4000,"description":"The text prompt describing the content, style, or composition of the image to be generated."},"num_images":{"type":"number","minimum":1,"maximum":4,"default":1,"description":"The number of images to generate."},"seed":{"type":"integer","minimum":1,"description":"The same seed and the same prompt given to the same version of the model will output the same image every time."},"guidance_scale":{"type":"number","minimum":1,"maximum":20,"description":"The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you."},"num_inference_steps":{"type":"integer","minimum":1,"maximum":50,"default":50,"description":"The number of inference steps to perform."},"enable_safety_checker":{"type":"boolean","default":true,"description":"If set to True, the safety checker will be enabled."},"image_url":{"type":"string","format":"uri","description":"The URL of the reference image."},"strength":{"type":"number","default":0.95,"description":"Determines how much the prompt influences the generated image."}},"required":["model","prompt","image_url"],"title":"flux/dev/image-to-image"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","nullable":true,"items":{"type":"object","properties":{"url":{"type":"string","nullable":true,"description":"The URL where the file can be downloaded from."},"b64_json":{"type":"string","nullable":true,"description":"The base64-encoded JSON of the generated image."}}},"description":"The list of generated images."},"meta":{"type":"object","nullable":true,"properties":{"usage":{"type":"object","nullable":true,"properties":{"credits_used":{"type":"number","description":"The number of tokens consumed during generation."}},"required":["credits_used"]}},"description":"Additional details about the generation."}}}}}}}}}}} ``` ## Quick Example Let's generate a new image using the one from the [flux/dev Quick Example](https://docs.aimlapi.com/api-references/image-models/flux-dev#quick-example) as a reference — and make a simple change to it with a prompt. {% tabs %} {% tab title="Python" %} {% code overflow="wrap" %} ```python import requests import json # for getting a structured output with indentation def main(): response = requests.post( "https://api.aimlapi.com/v1/images/generations", headers={ # Insert your AIML API Key instead of : "Authorization": "Bearer ", "Content-Type": "application/json", }, json={ "model": "flux/dev/image-to-image", "prompt": "Add a bird to the foreground of the photo.", "image_url": "https://raw.githubusercontent.com/aimlapi/api-docs/main/reference-files/t-rex.png", "strength": 0.8 } ) data = response.json() print(json.dumps(data, indent=2, ensure_ascii=False)) if __name__ == "__main__": main() ``` {% endcode %} {% endtab %} {% tab title="JS" %} {% code overflow="wrap" %} ```javascript async function main() { const response = await fetch('https://api.aimlapi.com/v1/images/generations', { method: 'POST', headers: { // Insert your AIML API Key instead of : 'Authorization': 'Bearer ', 'Content-Type': 'application/json', }, body: JSON.stringify({ model: 'flux/dev/image-to-image', prompt: 'A T-Rex relaxing on a beach, lying on a sun lounger and wearing sunglasses.', image_url: 'https://raw.githubusercontent.com/aimlapi/api-docs/main/reference-files/t-rex.png', strength: 0.8, }), }); const data = await response.json(); console.log(data); } main(); ``` {% endcode %} {% endtab %} {% endtabs %}
Response {% code overflow="wrap" %} ```json5 { images: [ { url: 'https://cdn.aimlapi.com/eagle/files/elephant/RmRsL9NMW_kkRy6MemjZJ_ac9897dd871842e2a689b8bc24b4bf08.jpg', width: 1472, height: 512, content_type: 'image/jpeg' } ], timings: { inference: 4.4450759180035675 }, seed: 3082066483, has_nsfw_concepts: [ false ], prompt: 'A T-Rex relaxing on a beach, lying on a sun lounger and wearing sunglasses.' } ``` {% endcode %}
| Reference Image | Generated Image | | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | | ![](https://cdn.aimlapi.com/eagle/files/monkey/GHx5aT0PR9GXtGi3Cx7CE.png) | |