MarketSupport← Back to app

GPT Image

GPT Image models are called through one unified, asynchronous job API. Start a task with POST /api/generate, then poll GET /api/generate/{taskId} until it finishes. This family exposes 4 endpoints.

Overview

Every endpoint shares the same envelope — only model and the input fields change. Run any from the Models Market playground.

Authentication

Create an API key at /api-keys, then send it as a Bearer token. Requests from the browser while logged in also work via the session cookie.

Authorization: Bearer <YOUR_API_KEY>

Create Task

POST
POST https://api.lithovas.com/api/generate

Body: { "model": "<slug>", "input": { … } }

Response: { "taskId": "<id>", "state": "waiting" }

Query Result

GET
GET https://api.lithovas.com/api/generate/<taskId>

Response: { "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }

Asynchronous
A 200 from Create Task only means the task was accepted — not finished. Poll this endpoint until state becomes success or fail. Failed tasks are not billed.

Endpoints

ModelTaskmodel slug
GPT Image 1.5Text to Imagegpt-image/1-5-text-to-image
GPT Image 1.5Image to Imagegpt-image/1-5-image-to-image
GPT Image 2Text to Imagegpt/gpt-image-2-text-to-image
GPT Image 2Image to Imagegpt/gpt-image-2-image-to-image

GPT Image 1.5 · Text to Image

POSTText to Imagegpt-image/1-5-text-to-image
input fields
promptstringrequired

Text description of the image to generate

aspect_ratioenum<string>required

Width-height ratio determining visual form

qualityenum<string>required

Medium for balanced output; high for detailed

Example
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image/1-5-text-to-image",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "aspect_ratio": "1:1",
    "quality": "medium"
  }
}'

GPT Image 1.5 · Image to Image

POSTImage to Imagegpt-image/1-5-image-to-image
input fields
input_urlsarray<string>required

Input image file URLs (max 16 URLs)

promptstringrequired

Text description of desired image generation or edit

aspect_ratioenum<string>required

Width-height ratio of the image

qualityenum<string>required

Quality: medium for balanced, high for detailed

Example
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image/1-5-image-to-image",
  "input": {
    "input_urls": [
      "https://example.com/file"
    ],
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "aspect_ratio": "3:2",
    "quality": "medium"
  }
}'

GPT Image 2 · Text to Image

POSTText to Imagegpt/gpt-image-2-text-to-image
input fields
promptstringrequired

Text prompt for image generation (max 20000 chars)

aspect_ratioenum<string>optional

Image aspect ratio (some ratios unavailable for 2K/4K)

resolutionenum<string>optional

Output image resolution

Example
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt/gpt-image-2-text-to-image",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "aspect_ratio": "auto",
    "resolution": "1K"
  }
}'

GPT Image 2 · Image to Image

POSTImage to Imagegpt/gpt-image-2-image-to-image
input fields
promptstringrequired

Text prompt for image generation, up to 20000 characters

input_urlsarray<string>required

Array of input image URLs (max 16 images)

aspect_ratioenum<string>optional

Output aspect ratio (5:4 and 4:5 limited to 1K)

resolutionenum<string>optional

Image resolution (1:1 cannot use 4K; auto limited to 1K)

Example
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt/gpt-image-2-image-to-image",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "input_urls": [
      "https://example.com/file"
    ],
    "aspect_ratio": "auto",
    "resolution": "1K"
  }
}'