Image

GPT Image 2 (Edit)

Credit-based pricing. Supports reference images, batch up to 4.

Try GPT Image 2 (Edit) →Compare models

Output

image

Aspect ratio

1:1, 3:2, 2:3, Auto

Resolution

1024, 2048

Max batch

Inputs

Reference image (required)

Batch up to 4 per request

Example prompt

Transform this living room into a lush tropical paradise — replace the walls with dense jungle foliage, add a waterfall feature in the corner, hang vibrant orchids and bromeliads from the ceiling, keep the marble coffee table but surround it with smooth river stones and emerald moss, golden afternoon sunlight streaming through the leaves

Try this prompt →

LLM-ready

API & LLM schema

Exact request contract for this model. Agents can fetch it from /api/v1/models?id=openai/gpt-image-2/edit.

POST/api/v1/generate15 fields · 3 required

Field	Type	Requirement	Contract
`model_id`	constant	Required	ArtEmotion model identifier.
`extra`	object	Optional	Model-specific settings may also be nested here.
`max_credits`	number	Optional	Reject before submission if the estimated list price exceeds this cap. · Range: 1–…
`webhook_url`	string	Optional	Format: uri
`webhook_secret`	string	Optional	Optional model input.
`folder_id`	string	Optional	Optional model input.
`prompt`	string	Required	Optional model input.
`output_format`	string	Optional	Output format for the images · Allowed: jpeg, png, webp · Default: png
`quality`	string	Optional	Quality for the generated image. Use 'auto' to let the model pick the best quality for the prompt. · Allowed: auto, low, medium, high · Default: medium
`mask_url`	string	Optional	URL of a mask image indicating which part of the image to edit (transparent areas are edited, opaque areas are preserved).
`output_compression`	number	Optional	Compression level for jpeg/webp output formats (100 = best quality). · Default: 100 · Range: 0–100
`aspect_ratio`	string	Optional	Allowed: 1:1, 3:2, 2:3, Auto
`resolution`	string	Optional	Allowed: 1024, 2048
`num_images`	integer	Optional	Range: 1–4
`reference_image_urls`	array<string>	Required	Items: 0–16

Minimal request example

{
  "model_id": "openai/gpt-image-2/edit",
  "prompt": "Transform this living room into a lush tropical paradise — replace the walls with dense jungle foliage, add a waterfall feature in the corner, hang vibrant orchids and bromeliads from the ceiling, keep the marble coffee table but surround it with smooth river stones and emerald moss, golden afternoon sunlight streaming through the leaves",
  "reference_image_urls": []
}

Raw JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=openai%2Fgpt-image-2%2Fedit",
  "title": "GPT Image 2 (Edit) generation request",
  "description": "Request body accepted by POST /api/v1/generate for openai/gpt-image-2/edit.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "openai/gpt-image-2/edit",
      "description": "ArtEmotion model identifier."
    },
    "extra": {
      "type": "object",
      "additionalProperties": true,
      "description": "Model-specific settings may also be nested here."
    },
    "max_credits": {
      "type": "number",
      "minimum": 1,
      "description": "Reject before submission if the estimated list price exceeds this cap."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048
    },
    "webhook_secret": {
      "type": "string",
      "maxLength": 512
    },
    "folder_id": {
      "type": "string"
    },
    "prompt": {
      "type": "string"
    },
    "output_format": {
      "title": "Output Format",
      "description": "Output format for the images",
      "default": "png",
      "type": "string",
      "enum": [
        "jpeg",
        "png",
        "webp"
      ]
    },
    "quality": {
      "title": "Quality",
      "description": "Quality for the generated image. Use 'auto' to let the model pick the best quality for the prompt.",
      "default": "medium",
      "type": "string",
      "enum": [
        "auto",
        "low",
        "medium",
        "high"
      ]
    },
    "mask_url": {
      "title": "Mask URL",
      "description": "URL of a mask image indicating which part of the image to edit (transparent areas are edited, opaque areas are preserved).",
      "type": "string"
    },
    "output_compression": {
      "title": "Output Compression",
      "description": "Compression level for jpeg/webp output formats (100 = best quality).",
      "default": 100,
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "multipleOf": 1
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "1:1",
        "3:2",
        "2:3",
        "Auto"
      ]
    },
    "resolution": {
      "type": "string",
      "enum": [
        "1024",
        "2048"
      ]
    },
    "num_images": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4
    },
    "reference_image_urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "maxItems": 16
    }
  },
  "required": [
    "model_id",
    "prompt",
    "reference_image_urls"
  ],
  "additionalProperties": false
}

Browse schemas for every ArtEmotion model →

FAQ

How much does GPT Image 2 (Edit) cost on ArtEmotion?

Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.

Do I get my credits back if GPT Image 2 (Edit) fails?

Yes — failed generations are never charged. The credits are released back to your balance automatically.

Can I call GPT Image 2 (Edit) from the API?

Yes. Use POST /api/v1/generate with model_id: "openai/gpt-image-2/edit". See the API reference for the full schema.

Where are my generations stored?

Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.

Ready to generate with GPT Image 2 (Edit)?

Start now →

No commitment. New accounts get 50 free credits on signup. See pricing.