How to Use the OpenAI GPT Image 2.5 Flare Text-to-Image API: text to image integration guide (2026)

2 min · Updated 2026-07-11 · By the NamiFusion team

Learn how to call the OpenAI GPT Image 2.5 Flare Text-to-Image API on NamiFusion: parameters, pricing (from ≈$0.220) and runnable copy-paste code — try it in the playground first.

OpenAI GPT Image 2.5 Flare Text-to-Image is a text to image model by OpenAI: Fast, balanced image generation from natural-language prompts, with up to 4K output. On NamiFusion you can try it in the playground (exact quote shown before you submit), then call it through one unified REST API — about $0.220 per typical run.

TL;DR

· Task type: text to image, provided by OpenAI

· Pricing: about $0.220 per typical run ($1 = 100 credits), pay-as-you-go

· Getting started: playground (exact quote before submit) → create an API key → one POST request

· Tunable parameters: 9 (see the table below)

· No platform watermark; commercial use allowed (per the Terms of Service)

What can you build with OpenAI GPT Image 2.5 Flare Text-to-Image?

Social media visuals and covers: batch-generate on-theme images and schedule them straight away.

E-commerce and ad creatives: product scenes, banner backgrounds, and multi-variant visuals for A/B tests.

Concept art and ideation: characters, environments and style boards, iterated cheaply and fast.

Pipeline chaining: outputs feed directly into image-to-video or face swap as source material.

Example outputs

Real outputs from this model (not cherry-picked retouches):

Example outputs — 1Example outputs — 2Example outputs — 3

How do you call this API?

  1. Sign up on NamiFusion and create a key on the API Keys page (signup bonus credits can only be used on selected models).
  2. Submit a task with the cURL example below, passing your key as a Bearer token.
  3. Poll the task status with the returned task_uuid and read the output URLs when completed.
Submit a task
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/openai/gpt-image-2.5-flare/text-to-image" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "A futuristic cityscape at sunset, with glowing skyscrapers and flying cars.",
    "n": 1,
    "aspect_ratio": "1:1",
    "resolution": "1k",
    "quality": "auto",
    "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"

What parameters does it take?

prompt (Prompt): required

n (Image Count): optional, default 1

aspect_ratio (Aspect Ratio): optional, default "1:1"

resolution (Resolution): optional, default "1k"

size (Size): optional

quality (Quality): optional, default "auto"

output_format (Output Format): optional, default "png"

output_compression (Compression): optional

moderation (Moderation): optional, default "auto"

How do you write prompts for OpenAI GPT Image 2.5 Flare Text-to-Image?

  1. Subject first: lead with the actor and action, then add environment, lighting and style ("an astronaut sprinting through a neon street in the rain, cinematic, shallow depth of field").
  2. Concrete nouns beat stacked adjectives: "85mm portrait lens, golden-hour backlight" works far better than "very beautiful, ultra high quality".
  3. Change one variable per iteration: pin the seed to reproduce a result, tweak a single phrase at a time so you know what actually moved the output.
  4. State negatives positively: instead of "no blur", ask for "sharp focus, crisp details".

How much does it cost?

Pay-per-use in credits. About $0.220 per typical run ($1 = 100 credits); the exact price varies with parameters like resolution or duration, and the playground shows the exact quote before you submit.

OpenAI GPT Image 2.5 Flare Text-to-Image

Fast, balanced image generation from natural-language prompts, with up to 4K output.

API endpoint

POST /api/v1/marketplace/run/openai/gpt-image-2.5-flare/text-to-image

Submit JSON as {"input": {...}}, then poll GET /api/v1/marketplace/run/tasks/{task_uuid} until the task completes.

Parameters

  • prompt (required): Image description, up to 5,000 characters.
  • n: 1 to 10 images; default 1.
  • 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, or 21:9.
  • resolution: 1k, 2k, or 4k; default 1k.
  • size: Optional explicit widthxheight; when supplied it overrides aspect_ratio and resolution.
  • quality: auto, low, medium, high, xhigh, or max; default auto.
  • output_format: png, jpeg, or webp; default png.
  • output_compression: 0 to 100; only relevant to compressed formats.
  • moderation: auto or low; default auto.

Output

{"images": ["https://..."]}

FAQ

Can I try it for free first?+

Signup bonus credits can only be used on selected models, and eligibility may change. The playground shows the exact quote before submission.

Can I use the output commercially? Is there a watermark?+

Yes, outputs are yours to use commercially, and NamiFusion adds no platform watermark — subject to the Terms of Service and applicable law.

What is the content policy?+

Pornographic content, sexualized content involving a minor, unauthorized use of real people, deceptive impersonation, fraud and false endorsements are prohibited. Lawful, consensual, non-explicit adult themes may be permitted; see the Terms of Service.

How long does a OpenAI GPT Image 2.5 Flare Text-to-Image task take?+

It depends on parameters — images usually take seconds, videos tens of seconds to minutes. The API returns a task_uuid for polling.

What are the resolution and duration limits?+

See the parameter table above — each model lists its available resolution and duration options there and in the playground.