OpenAI Async Image API

A single unified endpoint for both text-to-image generation and image editing. The operation type is auto-detected based on whether you provide an image field in the request body.

Supported Model

Model	Description
`gpt-image-2`	Latest OpenAI image model

How It Works

Create a task

Call POST /openai/images with your prompt. The endpoint auto-detects the operation:

No image field → text-to-image generation
With image field → image editing
With image + mask → inpainting (transparent mask areas are repainted)

Returns { "taskId": "..." }.

Poll for results

Call GET /openai/tasks?taskId=<taskId> until status is completed or failed.

Use the result

The task result field contains the generated image (base64 encoded by default for gpt-image-2).

Quick Examples

curl -X POST "https://api.mountsea.ai/openai/images" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A photorealistic cat wearing a space helmet, floating in orbit",
    "model": "gpt-image-2",
    "size": "1024x1024",
    "quality": "high"
  }'

curl -X POST "https://api.mountsea.ai/openai/images" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Add a vintage film grain and warm color tone",
    "model": "gpt-image-2",
    "image": "https://example.com/source.jpg",
    "size": "1024x1024",
    "input_fidelity": "high"
  }'

curl -X POST "https://api.mountsea.ai/openai/images" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Make the sky dramatic with stormy clouds",
    "model": "gpt-image-2",
    "image": "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
    "size": "1024x1024"
  }'

curl -X POST "https://api.mountsea.ai/openai/images" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Replace the background with a sunset beach",
    "model": "gpt-image-2",
    "image": "https://example.com/source.png",
    "mask": "https://example.com/mask.png"
  }'

curl -X GET "https://api.mountsea.ai/openai/tasks?taskId=your-task-id" \
  -H "Authorization: Bearer your-api-key"

Parameters

Field	Type	Required	Description
`prompt`	string	✅	Prompt describing the desired image (for editing: describe the modification)
`model`	string	—	Defaults to `gpt-image-2`
`size`	enum	—	`auto`, `1024x1024` (default), `1024x1536`, `1536x1024`
`n`	number	—	Generation count (currently only 1 supported)
`quality`	enum	—	`auto`, `low`, `medium`, `high`, `standard`
`background`	enum	—	`transparent`, `opaque`, `auto`
`output_format`	enum	—	`png` / `jpeg` / `webp`
`output_compression`	number	—	JPEG/WebP compression 0-100
`moderation`	enum	—	`auto`, `low`
`response_format`	enum	—	`url` or `b64_json` (gpt-image-2 always returns b64_json)
`input_fidelity`	enum	—	`high` or `low` — only for edit; controls how closely the output follows the input
`image`	string / string[]	—	URL or base64 data URL. Presence triggers editing mode. Single or multiple images
`mask`	string	—	Mask image (URL or base64). Transparent areas will be repainted. Edit-only

Task Status

Status	Meaning
`pending`	Task created, awaiting processing
`ready`	Ready for assignment
`assigned`	Assigned to a worker
`processing`	Actively generating
`completed`	Done — `result` contains the image
`failed`	Failed — see `errorMessage` / `errorCode`
`cancelled`	Cancelled by user or system
`timeout`	Exceeded processing timeout

Poll every 2-5 seconds. Tasks typically complete in 10-60 seconds depending on quality and size.

Available Endpoints

Endpoint	Method	Description
`/openai/images`	POST	Create image task (generate or edit)
`/openai/tasks`	GET	Get task status / result by taskId

Explore the API Documentation

Create Image Task — Async generate / edit / inpaint
Get Task Result — Poll task status and get results

Looking for the synchronous OpenAI-compatible API? See OpenAI Compat to use the official openai SDK.

​OpenAI Async Image API

​Supported Model

​How It Works

​Quick Examples

​Parameters

​Task Status

​Available Endpoints

​Explore the API Documentation

OpenAI Async Image API

Supported Model

How It Works

Quick Examples

Parameters

Task Status

Available Endpoints

Explore the API Documentation