OpenAI GPT Image 2.5 Sunburst Edit
openai/gpt-image-2.5-sunburst/edit
High-fidelity image editing for precise transformations using up to 16 reference images.
Examples
Parameters
| Name | Type | Default | Constraints | Description |
|---|---|---|---|---|
| images *Images | image_upload | — | image/* · 1–16 items | List of URLs of input images for editing. |
| prompt *Prompt | textarea | — | ≤ 5000 chars | The positive prompt for the generation. |
| nImage Count | slider | 1 | 1 ~ 10 | The number of images to generate (1-10). Each image is billed separately. |
| aspect_ratioAspect Ratio | select | 1:1 | 1:1 | 1:2 | 2:1 | 1:3 | 3:1 | 2:3 | 3:2 | 3:4 | … | The aspect ratio of the generated image. Ignored if 'size' is specified. |
| resolutionResolution | select | 1k | 1k | 2k | 4k | Output resolution level. Ignored if 'size' is specified. |
| sizeSize | text | — | — | Specific image resolution. The format is [width]x[height]. If specified, aspect_ratio and resolution will be ignored. |
| qualityQuality | select | auto | auto | low | medium | high | xhigh | max | Rendering quality. Higher quality costs more and takes longer. |
| maskMask Image | image_upload | — | image/* · 0–1 items | Reference an input image by URL. Provide exactly one. |
| backgroundBackground | select | auto | auto | transparent | opaque | Background behavior for generated image output. |
| input_fidelityInput Fidelity | select | low | low | high | Controls fidelity to the original input image(s). |
| output_formatOutput Format | select | png | png | jpeg | webp | The format of the output image. JPEG is faster for low latency. |
| output_compressionCompression | number | — | 0 ~ 100 | Compression level, only valid for JPEG/WebP (0-100). |
| moderationModeration | select | auto | auto | low | Content moderation level. |
Output fields
| Field | Type | Description |
|---|---|---|
| images | array<string> |
API
Call this model through one unified REST API. Get a key on the API Keys page.
cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/openai/gpt-image-2.5-sunburst/edit" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"images": [
"https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/08/19/b58b3f934797.jpeg"
],
"prompt": "A futuristic cityscape at sunset, with glowing skyscrapers and flying cars.",
"n": 1,
"aspect_ratio": "1:1",
"resolution": "1k",
"quality": "auto",
"background": "auto",
"input_fidelity": "low",
"output_format": "png",
"moderation": "auto"
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"Python
import time, requests
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1) Submit
resp = requests.post(
"https://www.namifusion.com/api/v1/marketplace/run/openai/gpt-image-2.5-sunburst/edit",
headers=HEADERS,
json={
"input": {
"images": [
"https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/08/19/b58b3f934797.jpeg"
],
"prompt": "A futuristic cityscape at sunset, with glowing skyscrapers and flying cars.",
"n": 1,
"aspect_ratio": "1:1",
"resolution": "1k",
"quality": "auto",
"background": "auto",
"input_fidelity": "low",
"output_format": "png",
"moderation": "auto"
}
},
)
resp.raise_for_status() # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()
# 2) Poll until a terminal state (completed / failed / cancelled).
# This model is allowed up to 600s server-side.
deadline = time.time() + 660
while task.get("status") not in ("completed", "failed", "cancelled"):
if time.time() > deadline:
raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
time.sleep(3)
poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
poll.raise_for_status()
task = poll.json()
print(task["status"], task.get("output"))JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };
// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/openai/gpt-image-2.5-sunburst/edit", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"images": [
"https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/08/19/b58b3f934797.jpeg"
],
"prompt": "A futuristic cityscape at sunset, with glowing skyscrapers and flying cars.",
"n": 1,
"aspect_ratio": "1:1",
"resolution": "1k",
"quality": "auto",
"background": "auto",
"input_fidelity": "low",
"output_format": "png",
"moderation": "auto"
}
}),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();
// 2) Poll until a terminal state (completed / failed / cancelled).
// This model is allowed up to 600s server-side.
const deadline = Date.now() + 660 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
await new Promise((r) => setTimeout(r, 3000));
const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
task = await poll.json();
}
console.log(task.status, task.output);Documentation
OpenAI GPT Image 2.5 Sunburst Edit
High-fidelity image editing for precise transformations using up to 16 reference images.
API endpoint
POST /api/v1/marketplace/run/openai/gpt-image-2.5-sunburst/edit
Submit JSON as {"input": {...}}, then poll GET /api/v1/marketplace/run/tasks/{task_uuid} until the task completes.
Parameters
images(required): 1 to 16 input image URLs.prompt(required): Editing instruction, up to 5,000 characters.mask: Optional mask image URL.background:auto,transparent, oropaque.input_fidelity:loworhigh.n: 1 to 10 images; default1.aspect_ratio:1:1,1:2,2:1,1:3,3:1,2:3,3:2,3:4,4:3,4:5,5:4,9:16,16:9,9:21, or21:9.resolution:1k,2k, or4k; default1k.size: Optional explicitwidthxheight; when supplied it overridesaspect_ratioandresolution.quality:auto,low,medium,high,xhigh, ormax; defaultauto.output_format:png,jpeg, orwebp; defaultpng.output_compression: 0 to 100; only relevant to compressed formats.moderation:autoorlow; defaultauto.
Output
{"images": ["https://..."]}
Pricing
Nami calculates the final charge from the actual token usage returned by MaaS. OpenAI Standard rates are $5.00/M text input tokens, $1.25/M cached text input tokens, $8.00/M image input tokens, $2.00/M cached image input tokens, and $30.00/M image output tokens.
Related models
xAI Grok Imagine Image v2.0 Edit
xAI Grok Imagine Image V2.0 Edit transforms input images with text prompts, with configurable resolution and quality for precise image editing, visual refinements, creative variations, social content, marketing assets, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
qwen-image-edit-spicy
Precisely edit images with text instructions. Add, remove, or modify visual elements, transfer styles, and replace backgrounds for photo retouching and visual design.
Qwen Image 3.0 Pro Edit | Fast Image Editing
Qwen Image 3.0 Pro Edit is a professional-grade image editing model with superior quality and advanced instruction understanding. Up to 2k. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
OpenAI GPT Image 2.5 Flare Edit
Fast, balanced image editing from natural-language instructions and up to 16 reference images.
Head Swap (Image)
Swap the head in a photo with the head from a reference image. Upload the target photo first, then the head reference.
Nano Banana Image Edit
Fast & Affordable Editing. Intuitive object replacement and style transfer without manual masking.
Nano Banana Pro Image Edit
4K Semantic Editing.Modifies existing images via natural language with context awareness and multilingual text editing.
Nano Banana 2 Image Edit
4K Semantic Editing.Modifies existing images via natural language with context awareness and multilingual text editing.