{"info":{"title":"tencent/hunyuan-image/v3/instruct/edit","version":"1.0.0"},"paths":{"/":{"post":{"summary":"Edit","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Output"}}},"description":"Successful Response"}},"operationId":"hunyuan_image_v3_instruct_edit","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Input"}}},"required":true}}}},"openapi":"3.1.0","components":{"schemas":{"Input":{"type":"object","title":"Input","required":["prompt","image_urls"],"properties":{"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seed","x-order":6,"description":"Random seed for reproducible results. The same seed and inputs produce the same edit; leave unset for a random seed."},"prompt":{"type":"string","title":"Prompt","x-order":0,"description":"The instruction describing how to edit the reference image(s)."},"image_size":{"anyOf":[{"$ref":"#/components/schemas/ImageSize"},{"$ref":"#/components/schemas/ImageSizeEnum"}],"title":"Image Size","default":"auto","x-order":2,"description":"The size of the edited image. Use a preset, an explicit width/height object, or 'auto' to let the model choose from the input image."},"image_urls":{"type":"array","items":{"type":"string","format":"uri"},"title":"Image Urls","x-order":1,"maxItems":3,"description":"The URLs of the images to use as a reference for the edit. A maximum of 3 images are supported."},"num_images":{"type":"integer","title":"Num Images","default":1,"maximum":4,"minimum":1,"x-order":3,"description":"The number of images to generate. Each generated image is billed."},"output_format":{"allOf":[{"$ref":"#/components/schemas/OutputFormatEnum"}],"title":"Output Format","default":"png","x-order":8,"description":"The format of the generated image."},"guidance_scale":{"type":"number","title":"Guidance Scale","default":3.5,"maximum":20,"x-order":4,"description":"The CFG scale. Higher values increase adherence to the prompt.","exclusiveMinimum":1},"enable_safety_checker":{"type":"boolean","title":"Enable Safety Checker","default":true,"x-order":7,"description":"If set to true, the safety checker will be enabled."},"enable_prompt_expansion":{"type":"boolean","title":"Enable Prompt Expansion","default":true,"x-order":5,"description":"Whether to enable prompt expansion. This uses a large language model to expand the prompt with additional details while maintaining the original meaning. Enabled by default; disable it to have your exact wording honored."}},"x-fal-order-properties":["prompt","image_urls","image_size","num_images","guidance_scale","enable_prompt_expansion","seed","enable_safety_checker","output_format"]},"Output":{"type":"array","items":{"type":"string","format":"uri"},"title":"Output","description":"The edited image files."},"ImageSize":{"type":"object","title":"ImageSize","properties":{"width":{"type":"integer","title":"Width","default":512,"maximum":14142,"description":"The width of the generated image.","exclusiveMinimum":0},"height":{"type":"integer","title":"Height","default":512,"maximum":14142,"description":"The height of the generated image.","exclusiveMinimum":0}}},"ImageSizeEnum":{"enum":["auto","square_hd","square","portrait_4_3","portrait_16_9","landscape_4_3","landscape_16_9"],"type":"string","title":"ImageSizeEnum","description":"Predefined image sizes."},"OutputFormatEnum":{"enum":["jpeg","png"],"type":"string","title":"OutputFormatEnum","description":"The format of the generated image."}}}}