PixMind Docs
Api referenceImage ModelsGPT Image 2

GPT Image 2 Image Generation

Generate and edit images with GPT Image 2 quality and resolution controls.

High-control image generation and editing with independent quality and resolution controls.

Provider

OpenAI

Model ID

gpt-image-2

Endpoint

POST /v1/generations

Model notes

  • Both quality and size participate in pricing.
  • Each reference image adds $0.008 to the request.

Request parameters

ParameterTypeRequiredDescription
modelstringYes

Stable PixMind model ID. Use `gpt-image-2`.

Allowed values: gpt-image-2

promptstringYes

Natural-language generation or editing instructions.

qualitystringNo

Generation quality tier.

Allowed values: low, medium, high

Default: medium

sizestringNo

Output resolution tier. This field affects request pricing.

Allowed values: 1K, 2K, 4K

Default: 2K

aspect_ratiostringNo

Requested output aspect ratio.

Allowed values: auto, 1:1, 16:9, 9:16, 4:3, 3:4

Default: auto

reference_imagesstring[] (URI)No

Reference image URLs used for editing, composition, subject, or style guidance.

callback_urlstring (URI)No

HTTPS endpoint that receives the terminal task event. Polling remains available when omitted.

Request example

cURL
curl https://aihub-admin.aimix.pro/v1/generations \
  -H "Authorization: Bearer $PIXMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2",
  "prompt": "Create a premium skincare campaign image and preserve the supplied package design",
  "quality": "medium",
  "size": "2K",
  "aspect_ratio": "1:1",
  "reference_images": [
    "https://example.com/package.png"
  ]
}'
JavaScript
const response = await fetch("https://aihub-admin.aimix.pro/v1/generations", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.PIXMIND_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "gpt-image-2",
  "prompt": "Create a premium skincare campaign image and preserve the supplied package design",
  "quality": "medium",
  "size": "2K",
  "aspect_ratio": "1:1",
  "reference_images": [
    "https://example.com/package.png"
  ]
})
});

const task = await response.json();

Accepted task response

Generation is asynchronous. Save the id from the response and poll GET /v1/generations/{id} until it reaches a terminal status.

202 Accepted
{
  "id": "img_01JXYZ...",
  "model": "gpt-image-2",
  "status": "processing"
}

API pricing

ConfigurationPrice
Low · 1K / 2K / 4K$0.040 / $0.056 / $0.080
Medium · 1K / 2K / 4K$0.064 / $0.120 / $0.240
High · 1K / 2K / 4K$0.240 / $0.400 / $0.480
Reference image surcharge$0.008 / image

API pricing uses the apiPlatform role and is separate from PixMind Studio credits. The accepted task response is the final pricing snapshot.