{"info":{"title":"tencent/hunyuan-image/v3/instruct/text-to-image","version":"1.0.0"},"paths":{"/":{"post":{"summary":"Generate","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Output"}}},"description":"Successful Response"}},"operationId":"hunyuan_image_v3_instruct_text_to_image_generate","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Input"}}},"required":true}}}},"openapi":"3.1.0","components":{"schemas":{"Input":{"type":"object","title":"Input","required":["prompt"],"properties":{"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seed","x-order":5,"description":"Random seed for reproducible results. The same seed and prompt produce the same image; leave unset for a random seed."},"prompt":{"type":"string","title":"Prompt","x-order":0,"description":"The text prompt describing the image you want to generate."},"image_size":{"anyOf":[{"$ref":"#/components/schemas/ImageSize"},{"$ref":"#/components/schemas/ImageSizeEnum"}],"title":"Image Size","default":"auto","x-order":1,"description":"The size of the generated image. Use a preset, an explicit width/height object, or 'auto' to let the model choose."},"num_images":{"type":"integer","title":"Num Images","default":1,"maximum":4,"minimum":1,"x-order":2,"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":7,"description":"The format of the generated image."},"guidance_scale":{"type":"number","title":"Guidance Scale","default":3.5,"maximum":20,"x-order":3,"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":6,"description":"If set to true, the safety checker will be enabled."},"enable_prompt_expansion":{"type":"boolean","title":"Enable Prompt Expansion","default":true,"x-order":4,"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_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 generated 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."}}}}