ChatGPT Image

Create Image

Generate one or more AI images from a text prompt, with optional reference images. Returns immediately with 202 Accepted and a task ID for polling.

When one or more reference_images are supplied, the request is treated as an image edit; otherwise it is a plain generation.

Example

curl -X POST https://genaipro.io/api/v2/gt-mage/create-image \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "prompt=A futuristic city at night" \
  -F "size=16:9" \
  -F "n=2"

Example — with reference images (edit)

curl -X POST https://genaipro.io/api/v2/gt-mage/create-image \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "prompt=Turn this into a watercolor painting" \
  -F "reference_images=@photo.jpg"

Rate limit: 30 requests/minute

post/v2/gt-mage/create-image

Response

Task accepted for processing

idstring

Task ID

promptstring

The prompt used for generation

file_urlsstring[]

URLs of the generated files (empty while processing)

status'processing' | 'completed' | 'failed'

Task status

errorstring

Error message (only present when status is failed)

created_atstring date-time

Timestamp when the task was created

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "prompt": "A cat walking on the beach at sunset",
  "file_urls": []
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.