{"input_schema":{"type":"object","properties":{"prompt":{"type":"string","description":"Describe the image or the requested edit.","examples":["A blue ceramic bowl on a white table"],"maxLength":32000},"images":{"type":"array","description":"For editing, 1–16 objects containing image_url (HTTP(S) or image data URL) or b64. Each remote image is at most 50 MiB; inline images and masks together must fit the 32 MiB complete request limit."},"mask":{"type":"object","description":"Optional editing mask with image_url or b64. Must be PNG with alpha and match the first input image dimensions."},"n":{"type":"integer","description":"Number of output images.","default":1,"minimum":1,"maximum":10},"size":{"type":"string","description":"auto or WIDTHxHEIGHT; sides multiples of 16, longest at most 3840, ratio at most 3:1 and 655360–8294400 pixels. Sizes above 2560x1440 are experimental.","default":"auto","examples":["1024x1024"]},"quality":{"type":"string","description":"Rendering quality; higher settings can consume more output tokens.","enum":["low","medium","high","xhigh","max","auto"],"default":"auto"},"output_format":{"type":"string","description":"Generated image encoding.","enum":["png","jpeg","webp"],"default":"png"},"output_compression":{"type":"integer","description":"JPEG/WebP compression only.","minimum":0,"maximum":100},"moderation":{"type":"string","description":"Content moderation setting.","enum":["auto","low"],"default":"auto"},"background":{"type":"string","description":"Editing background; transparent is unsupported.","enum":["auto","opaque"]},"input_fidelity":{"type":"string","description":"Editing fidelity is fixed at high.","enum":["high"]},"response_format":{"type":"string","description":"Only base64 output is supported.","enum":["b64_json"]},"stream":{"type":"boolean","description":"Generation only: return gateway run SSE with validated image previews and a final run.completed or run.failed event. Requires n=1 and no images input. The current supplier rejects streaming edits; use stream=false for edits.","default":false},"partial_images":{"type":"integer","description":"Maximum preview images; nonzero requires stream=true. Previews are not separate billable generations.","default":0,"minimum":0,"maximum":3}},"required":["prompt"],"additionalProperties":true,"examples":[{"prompt":"A blue ceramic bowl on a white table","size":"1024x1024","quality":"low","output_format":"jpeg"}]},"output_schema":{"type":"object","description":"Decode run.output.data[].b64_json after COMPLETED. Token-priced routes report text/image input, cached input and image output token counts. Flat-price routes report no token usage.","additionalProperties":true},"addons_schema":{"type":"object","additionalProperties":false},"capability_id":"openai.image-2.5","session_compatible":true,"pricing_available":true,"id":"openai/gpt-image-2.5-sunburst","object":"endpoint","provider":"openai","endpoint":"gpt-image-2.5-sunburst","model_category":"image","name":"GPT Image 2.5 Sunburst","summary":"Generate or edit images with text and optional reference images.","description":"Generate images, or provide images for editing and composition. Billing depends on the request and configured pricing route. Consult pricing_routes for eligible flat-price generation; other requests use native token billing with separate text, image and cached input rates. Without streaming, poll the run until COMPLETED; acceptance alone does not indicate completion. With input.stream=true, POST /v1/run returns gateway SSE: image_generation.partial_image previews followed by run.completed containing the final run, or run.failed. This is the gateway run protocol, not the OpenAI Images or Responses API. Streaming currently requires n=1. Reusing an Idempotency-Key replays the saved run without regenerating previews or charging twice. The complete request is limited to 32 MiB; an encoded result or individual SSE event is limited to 27 MiB and a stream to 108 MiB. Large batches or PNG outputs can exceed the result limit; prefer fewer images or JPEG/WebP compression. Interrupted or unverified results remain pending for reconciliation; never resubmit with a new key to recover a known run.","unit":"token","price_per_unit":null,"list_price_per_unit":null,"pricing":[{"meter":"INPUT_TOKEN","unit":"token","price_per_unit":"0.000004675","list_price_per_unit":"0.000005"},{"meter":"CACHED_INPUT_TOKEN","unit":"token","price_per_unit":"0.00000116875","list_price_per_unit":"0.00000125"},{"meter":"IMAGE_INPUT_TOKEN","unit":"token","price_per_unit":"0.00000748","list_price_per_unit":"0.000008"},{"meter":"CACHED_IMAGE_INPUT_TOKEN","unit":"token","price_per_unit":"0.00000187","list_price_per_unit":"0.000002"},{"meter":"OUTPUT_TOKEN","unit":"token","price_per_unit":"0","list_price_per_unit":"0"},{"meter":"IMAGE_OUTPUT_TOKEN","unit":"token","price_per_unit":"0.00002805","list_price_per_unit":"0.00003"}],"reports_cost":false,"input_fields":[{"name":"prompt","type":"string","required":true,"description":"Describe the image or the requested edit.","example":"A blue ceramic bowl on a white table","max":32000},{"name":"images","type":"array","required":false,"description":"For editing, 1–16 objects containing image_url (HTTP(S) or image data URL) or b64. Each remote image is at most 50 MiB; inline images and masks together must fit the 32 MiB complete request limit."},{"name":"mask","type":"object","required":false,"description":"Optional editing mask with image_url or b64. Must be PNG with alpha and match the first input image dimensions."},{"name":"n","type":"integer","required":false,"description":"Number of output images.","default":1,"min":1,"max":10},{"name":"size","type":"string","required":false,"description":"auto or WIDTHxHEIGHT; sides multiples of 16, longest at most 3840, ratio at most 3:1 and 655360–8294400 pixels. Sizes above 2560x1440 are experimental.","example":"1024x1024","default":"auto"},{"name":"quality","type":"string","required":false,"description":"Rendering quality; higher settings can consume more output tokens.","default":"auto","enum_values":["low","medium","high","xhigh","max","auto"]},{"name":"output_format","type":"string","required":false,"description":"Generated image encoding.","default":"png","enum_values":["png","jpeg","webp"]},{"name":"output_compression","type":"integer","required":false,"description":"JPEG/WebP compression only.","min":0,"max":100},{"name":"moderation","type":"string","required":false,"description":"Content moderation setting.","default":"auto","enum_values":["auto","low"]},{"name":"background","type":"string","required":false,"description":"Editing background; transparent is unsupported.","enum_values":["auto","opaque"]},{"name":"input_fidelity","type":"string","required":false,"description":"Editing fidelity is fixed at high.","enum_values":["high"]},{"name":"response_format","type":"string","required":false,"description":"Only base64 output is supported.","enum_values":["b64_json"]},{"name":"stream","type":"boolean","required":false,"description":"Generation only: return gateway run SSE with validated image previews and a final run.completed or run.failed event. Requires n=1 and no images input. The current supplier rejects streaming edits; use stream=false for edits.","default":false},{"name":"partial_images","type":"integer","required":false,"description":"Maximum preview images; nonzero requires stream=true. Previews are not separate billable generations.","default":0,"min":0,"max":3}],"example_request":{"provider":"openai","endpoint":"gpt-image-2.5-sunburst","input":{"prompt":"A blue ceramic bowl on a white table","size":"1024x1024","quality":"low","output_format":"jpeg"}},"output":"Decode run.output.data[].b64_json after COMPLETED. Token-priced routes report text/image input, cached input and image output token counts. Flat-price routes report no token usage.","limits":{"request_bytes":33554432,"timeout_ms":630000,"input_characters":{"field":"prompt","max":32000},"audio_bytes":null},"pricing_routes":[{"label":"Single image generation","instruction":"Flat price for prompt, one of the listed exact sizes, and quality auto, low, medium or high (auto when omitted), with no additional fields. 4K square is 2880x2880.","matches_example":false,"unit":"image","pricing_tiers":[{"input_field":"size","input_value":"1024x1024","input_conditions":{"size":"1024x1024"},"is_default":true,"available":true,"unit":"image","price_per_unit":"0.024745489943","list_price_per_unit":"0.026440314076"},{"input_field":"size","input_value":"1360x768","input_conditions":{"size":"1360x768"},"is_default":false,"available":true,"unit":"image","price_per_unit":"0.024745489943","list_price_per_unit":"0.026440314076"},{"input_field":"size","input_value":"768x1360","input_conditions":{"size":"768x1360"},"is_default":false,"available":true,"unit":"image","price_per_unit":"0.024745489943","list_price_per_unit":"0.026440314076"},{"input_field":"size","input_value":"2048x2048","input_conditions":{"size":"2048x2048"},"is_default":false,"available":true,"unit":"image","price_per_unit":"0.029694587932","list_price_per_unit":"0.031728376891"},{"input_field":"size","input_value":"2736x1536","input_conditions":{"size":"2736x1536"},"is_default":false,"available":true,"unit":"image","price_per_unit":"0.029694587932","list_price_per_unit":"0.031728376891"},{"input_field":"size","input_value":"1536x2736","input_conditions":{"size":"1536x2736"},"is_default":false,"available":true,"unit":"image","price_per_unit":"0.029694587932","list_price_per_unit":"0.031728376891"},{"input_field":"size","input_value":"2880x2880","input_conditions":{"size":"2880x2880"},"is_default":false,"available":true,"unit":"image","price_per_unit":"0.032993986591","list_price_per_unit":"0.035253752101"},{"input_field":"size","input_value":"3840x2160","input_conditions":{"size":"3840x2160"},"is_default":false,"available":true,"unit":"image","price_per_unit":"0.032993986591","list_price_per_unit":"0.035253752101"},{"input_field":"size","input_value":"2160x3840","input_conditions":{"size":"2160x3840"},"is_default":false,"available":true,"unit":"image","price_per_unit":"0.032993986591","list_price_per_unit":"0.035253752101"}]},{"label":"Other requests","instruction":"All other supported requests use native token pricing, including editing and streaming.","matches_example":true,"unit":"token","pricing_tiers":[{"input_field":"request","input_value":"other","is_default":true,"available":true,"unit":"token","price_per_unit":null,"list_price_per_unit":null,"pricing":[{"meter":"INPUT_TOKEN","unit":"token","price_per_unit":"0.000004675","list_price_per_unit":"0.000005"},{"meter":"CACHED_INPUT_TOKEN","unit":"token","price_per_unit":"0.00000116875","list_price_per_unit":"0.00000125"},{"meter":"IMAGE_INPUT_TOKEN","unit":"token","price_per_unit":"0.00000748","list_price_per_unit":"0.000008"},{"meter":"CACHED_IMAGE_INPUT_TOKEN","unit":"token","price_per_unit":"0.00000187","list_price_per_unit":"0.000002"},{"meter":"OUTPUT_TOKEN","unit":"token","price_per_unit":"0","list_price_per_unit":"0"},{"meter":"IMAGE_OUTPUT_TOKEN","unit":"token","price_per_unit":"0.00002805","list_price_per_unit":"0.00003"}]}]}]}