GPT Image 2 · Image Edit

Edit source images with GPT Image 2 through the SeeAPI or Replicate provider. Provide image URLs and a text prompt, configure the aspect ratio and resolution, then use the returned generation ID to track the asynchronous task.

Developer API pricing

Provider: SeeAPI

USD estimate: $0.0037 / credit · Estimated equivalent, not an additional charge.

1K: 10 credits/gen (≈ $0.037/gen)

Query Task Status

After submitting a task, use the unified query endpoint to check progress and retrieve results:

Get Task DetailsLearn how to query task status and retrieve generation results

Related Resources

Market Overview

Explore all available models

Credits & Billing

View credit balance, plans, and billing activity

Usage

Review API usage and credit consumption

Callbacks

Manage the secret used to verify generation webhook signatures. Callback URLs are supplied when you create each generation.

Webhook flow

Callback URL per generation.

Webhook signing key

Request

POST/v1/generations

AuthorizationSend your API key in the Authorization header using the Bearer scheme.Authorization: Bearer ****************

Header Params

stringrequired

A unique key for this generation request. Reuse the same value only when retrying the identical request body.

max length: 255

Example:: order-20260818-001

Body Params

application/json

stringrequired

The public model ID documented on this page. Use gpt-image-2 for this Endpoint.

Allowed:gpt-image-2

Default:: gpt-image-2
Example:: gpt-image-2

stringrequired

The public Endpoint ID for the selected model. Use the Endpoint whose input schema matches this request.

Allowed:image-to-image

Default:: image-to-image
Example:: image-to-image

stringoptional

Optional public Provider ID. Omit it to use `seeapi`, or set it to `replicate` to use the Replicate-specific input rules.

Allowed:seeapireplicate

Default:: seeapi
Example:: seeapi

objectrequired

Provider-specific image-editing parameters. Use the field group for the selected `provider`; unsupported fields or combinations are rejected.

Provider parameters

SeeAPIseeapiDefault Provider

stringrequired

Describe how the source images should be edited, including the desired subject, composition, style, lighting, and other important details. Up to 20,000 characters.

max length: 4000

Example:: A cinematic city at night

array <uri>required

Source images used by this Endpoint. Provide reachable image URLs and follow the count and format limits shown for this Provider.

min items: 1max items: 14

Example:: ["https://client.example.com/input.png"]

stringoptional

Select the output width-to-height ratio. Use `auto` to let SeeAPI determine the ratio.

Resolution availability depends on this value; see `resolution`.

Allowed:16:99:16auto1:14:33:4

Default:: auto

stringoptional

Select `1K`, `2K`, or `4K`. Available values depend on `aspect_ratio`.

`auto`, `5:4`, and `4:5` support `1K` resolution only.
`1:1` supports `1K` and `2K`; `4K` is not supported.

Allowed:1K2K4K

Default:: 1K

stringoptional

This parameter is only supported when the resolution is 1K. Available when resolution is "1K".

Allowed:autoopaquetransparent

Replicatereplicate

stringrequired

Describe how the source images should be edited, including the desired subject, composition, style, lighting, and other important details. Up to 20,000 characters.

max length: 4000

Example:: A cinematic city at night

array <uri>required

Source images used by this Endpoint. Provide reachable image URLs and follow the count and format limits shown for this Provider.

min items: 1max items: 14

Example:: ["https://client.example.com/input.png"]

stringoptional

Select the output width-to-height ratio. Use `auto` to let Replicate determine the ratio.

Allowed:16:99:16auto1:13:22:34:33:4

Default:: auto

stringoptional

Select `1K`, `2K`, or `4K` for the requested output resolution.

Allowed:1K2K4K

Default:: 1K

stringoptional

Choose the output image format. Some values depend on background.

Transparent backgrounds require PNG or WebP output.

Allowed:webppngjpeg

Default:: png

numberoptional

Set the output compression level from 0 to 100.

min: 0max: 100

Default:: 30

stringoptional

Choose automatic, transparent, or opaque background.

Allowed:autotransparentopaque

Default:: auto

string <uri>optional

Optional absolute HTTPS URL that receives terminal generation updates. If omitted, query the task-details endpoint with the returned generation ID.

max length: 2048

Example:: https://client.example.com/webhooks/seeapi

Responses

202Generation accepted and processing

Bodyapplication/json

objectrequired

stringrequired

Example:: task_xxx

stringrequired

Example:: gpt-image-2

stringrequired

Example:: image-to-image

stringrequired

Allowed:seeapireplicate

seeapi: SeeAPI
replicate: Replicate

Example:: seeapi

stringrequired

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 10

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

200Idempotent replay of an existing generation request

Bodyapplication/json

objectrequired

stringrequired

Example:: task_xxx

stringrequired

Example:: gpt-image-2

stringrequired

Example:: image-to-image

stringrequired

Allowed:seeapireplicate

seeapi: SeeAPI
replicate: Replicate

Example:: seeapi

stringrequired

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 10

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

400

Invalid JSON, parameters, Schema, or API Policy

401

Invalid API Key or authentication failed

402

Insufficient credits

403

The current request is not allowed

404

Model, Endpoint, or task not found

409

Idempotency conflict or the same request is still being created

413

Request body is too large

429

Too many requests

503

Service temporarily unavailable

Code Examples

Request

const response = await fetch("https://api.seeapi.com/v1/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Idempotency-Key": "order-20260818-001",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "gpt-image-2",
  "endpoint": "image-to-image",
  "provider": "seeapi",
  "input": {
    "prompt": "A cinematic city at night",
    "input_images": [
      "https://client.example.com/input.png"
    ],
    "aspect_ratio": "auto",
    "resolution": "1K",
    "background": "auto"
  },
  "callback_url": "https://client.example.com/webhooks/seeapi"
})
});

const result = await response.json();

ResponseHTTP 202

{
  "generation": {
    "id": "task_xxx",
    "model": "gpt-image-2",
    "endpoint": "image-to-image",
    "provider": "seeapi",
    "status": "processing",
    "estimated_credits": 10,
    "consumed_credits": 0,
    "refunded_credits": 0,
    "created_at": "2026-08-18T10:00:00Z",
    "updated_at": "2026-08-18T10:00:00Z"
  },
  "idempotent": false
}

const response = await fetch("https://api.seeapi.com/v1/generations", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Idempotency-Key": "order-20260818-001", "Content-Type": "application/json" }, body: JSON.stringify({ "model": "gpt-image-2", "endpoint": "image-to-image", "provider": "seeapi", "input": { "prompt": "A cinematic city at night", "input_images": [ "https://client.example.com/input.png" ], "aspect_ratio": "auto", "resolution": "1K", "background": "auto" }, "callback_url": "https://client.example.com/webhooks/seeapi" }) }); const result = await response.json();

{ "generation": { "id": "task_xxx", "model": "gpt-image-2", "endpoint": "image-to-image", "provider": "seeapi", "status": "processing", "estimated_credits": 10, "consumed_credits": 0, "refunded_credits": 0, "created_at": "2026-08-18T10:00:00Z", "updated_at": "2026-08-18T10:00:00Z" }, "idempotent": false }

Responses

202Generation accepted and processing

Bodyapplication/json

objectrequired

stringrequired

Example:: task_xxx

stringrequired

Example:: gpt-image-2

stringrequired

Example:: image-to-image

stringrequired

Allowed:seeapireplicate

seeapi: SeeAPI
replicate: Replicate

Example:: seeapi

stringrequired

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 10

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

200Idempotent replay of an existing generation request

Bodyapplication/json

objectrequired

stringrequired

Example:: task_xxx

stringrequired

Example:: gpt-image-2

stringrequired

Example:: image-to-image

stringrequired

Allowed:seeapireplicate

seeapi: SeeAPI
replicate: Replicate

Example:: seeapi

stringrequired

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 10

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

400

Invalid JSON, parameters, Schema, or API Policy

401

Invalid API Key or authentication failed

402

Insufficient credits

403

The current request is not allowed

404

Model, Endpoint, or task not found

409

Idempotency conflict or the same request is still being created

413

Request body is too large

429

Too many requests

503

Service temporarily unavailable