All models

gpt-image-2:official

OpenAIImage
Get your API key
gpt-image-2:official

Image model for text posters and precise reference image editing

gpt-image-2:official is the image generation and editing model for OpenAI GPT Image 2, suitable for turning text ideas, product photos, and character references into deliverable visual assets. It focuses on text in images, layout composition, and reference image-guided creation. It can generate posters and infographics from scratch, as well as modify colors, backgrounds, or local objects in existing images, making it suitable for design workflows that require repeated reviews.

OpenAIModel brand
ImageModel type
ImageTask capability

Specifications and API features

Clarify capacity, inputs and outputs, and invocation methods before selecting a model.

Creation methods
Text-to-image generation; reference image editing; multipart masked local editing
Reference image input
Editing supports a single URL, an array of up to 16 URLs, or local file uploads
Output quantity
1–10 images per request; only 1 image is supported when response_format=b64_json
Canvas control
size=auto or WIDTHxHEIGHT; width and height must be multiples of 16, with the long side not exceeding 3840 pixels
Pixel range
Total pixels 655,360–8,294,400; aspect ratio must not exceed 3:1
Quality and files
Common quality options are auto, low, medium, high; outputs PNG, JPEG, WebP
Local editing mask
Alpha PNG, no more than 4MB, the same dimensions as the first original image; transparent areas can be modified

GPT Image 2 provides image creation and editing capabilities. The quantities, dimensions, formats, and upload rules above correspond to how this model is invoked on this platform.

Core Capabilities

Learn what gpt-image-2:official can bring to your work.

Integrate Copy into Images

Suitable for generating headlines, slogans, descriptive labels, and the main image together, rather than merely drawing a text-free background. When creating, you can specify the main headline position, font-size hierarchy, whitespace, and color scheme, guiding a poster or infographic toward the intended visual structure; the final copy, numbers, and reading order should still be checked character by character.

Constrain Creativity with Reference Images

When editing, you can provide product, character, or style references at the same time, and explain the role of each image, such as preserving a product's appearance, drawing from a background color palette, or adjusting the shooting atmosphere. This is suitable for developing different creative directions around existing assets, but reference images are creative constraints and do not mean trademarks, faces, and fine structures will remain unchanged pixel for pixel.

Focus Changes on Local Content

Mask editing can focus changes on a specified area, such as replacing an object on a tabletop, adjusting part of an outfit, or adding background elements. Prompts should describe both the complete target image and the content that needs to be preserved; clear Alpha boundaries help express intent, but edge blending still needs to be checked after the image is generated.

Use Cases

Start with specific tasks to find where the model can be effective.

Event Posters and Infographics

Enter the event title, verified information, brand color palette, and layout requirements to generate promotional posters or infographics for proposals. It is recommended to distinguish between text that must be presented accurately and decorative content that can be freely created; when delivering, focus on checking dates, prices, labels, and hierarchy, then complete layout proofreading before formal publication.

Product Creative and Scene Image Editing

Provide a clear product image and specify the packaging, outline, and viewing angle to preserve, then try different backgrounds, colors, or lifestyle scenes. Suitable for e-commerce key visuals, advertising proposals, and packaging mockups; use masks when only local changes are needed, and compare the generated image with the original afterward to check brand marks and product details.

Character Design and Multi-Option Proposals

Enter character references, clothing details, expression requirements, and image layout to create character design sheets or creative candidates around the same theme. Use multiple generations when multiple directions are needed, making it easy to compare composition and style; for ongoing projects, retain selected reference images and check the consistency of faces, clothing, and props one by one.

How to choose this model

Choose based on task complexity, input materials, and expected results.

Choose it when generation and image editing need to work together seamlessly

If a task requires both generating a draft from text and continuing to refine a selected image, GPT Image 2 is suitable as a creative tool for the same workflow. First use low or medium quality to validate the composition, then increase the quality to inspect details. Existing Image 1.5 projects can use the same copy and reference materials for comparison, focusing on text, layout, and editing results rather than deciding migration solely by version number.

Make trade-offs with 2.5 variants based on your goals

GPT Image 2.5 Flare focuses on generation speed, while Sunburst focuses on high fidelity and fine control; GPT Image 2 is suitable for tasks such as text posters, product creatives, and reference image editing. Existing qualified templates can continue using this model; if delivery priorities shift to speed or more detailed editing control, compare the relevant variants with real materials without assuming a fixed degree of improvement.

Get started

From a small-scale task to full integration.

01

Prepare tasks and materials

Define goals, required inputs, and output requirements, using real business examples as a starting point.

02

Try it in the API playground

Open the trial page, confirm the parameters supported by this entry point, then submit a small-scale task to review the results.

03

Integrate according to the API documentation

Keep the complete model ID, use the request format specified in the documentation, and confirm billing rules on the Pricing page.

Usage limitations

Before formal use, understand the range of output quality and capabilities.

  • Text in images and structured layouts still require human review. Long passages, dense labels, precise alignment, and cross-image character consistency may deviate from requirements; when dates, prices, or chart data are involved, provide accurate content and include word-by-word verification in the delivery process rather than letting the model replace fact-checking.
  • Masks are not hard-edged selections like those in traditional image software. When using them, upload the original image and mask together via multipart; do not mix a URL original image with a local mask. The mask must have an Alpha channel. Even if the region is set correctly, edge blending and nearby details may still change.
  • The canvas must meet limits for side length, total pixels, and aspect ratio at the same time; do not consider only one size requirement. size=auto is suitable for exploring compositions, while precise delivery should specify pixel values; this model outputs static images and will not automatically perform ChatGPT-style web retrieval, multi-step orchestration, or video production.

Frequently Asked Questions

Answers to common questions about using gpt-image-2:official.

Is gpt-image-2:official a separate new model?

It is not another independent base model, but a public invocation ID variant of GPT Image 2. Both generation and editing requests should explicitly specify gpt-image-2:official; it shares the same core creative positioning as the ID without the suffix, but invocation and billing should be distinguished according to the selected model.

Which endpoint should reference images be sent to?

Use /openai/images/generations to create from text; when an existing image needs modification, use /openai/images/edits and pass a single URL, an array of URLs, or an uploaded file through image. For multi-image input, specify the role each image plays for the subject, style, or scene.

How do I modify only part of an image?

Use the editing endpoint and place the local original image and mask in the same multipart request. The mask must be an Alpha PNG of the same dimensions, with transparent areas indicating where modifications are allowed; the prompt should also clearly describe the intended changes and content to preserve, then check the region edges and surrounding details after generation.

Can I return multiple images or Base64 at once?

You can use n to request 1–10 candidate images, making it easier to compare different compositions. response_format can be url or b64_json, but Base64 responses support only a single image. The output file format is separately controlled by output_format, with PNG, JPEG, or WebP available.

How do I handle longer generations and costs?

You can add callback_url so the request first returns task_id and you receive the final result when it is complete; synchronous mode returns image data directly. This model is billed based on actual Token usage, and the amount before a request is an estimate. Saving task IDs and deduplicating callbacks helps manage long-running tasks and avoid duplicate processing.

Model information · Updated: 2026-10-01. See the API and pricing sections for invocation parameters and billing rules.

Use gpt-image-2:official for your next task

Start with a clear objective and evaluate whether it suits your work based on real results.