MercadoSoporte← Volver a la app

GPT Image

Los modelos de GPT Image se llaman a través de una API de trabajos asíncrona y unificada. Inicia una tarea con POST /api/generate y luego sondea GET /api/generate/{taskId} hasta que termine. Esta familia expone 4 endpoints.

Resumen

Todos los endpoints comparten la misma envoltura — solo cambian model y los campos input. Ejecuta cualquiera desde el playground del Mercado de modelos.

Autenticación

Crea una API key en /api-keys y luego envíala como token Bearer. Las solicitudes desde el navegador con sesión iniciada también funcionan mediante la cookie de sesión.

Authorization: Bearer <YOUR_API_KEY>

Crear tarea

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

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

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

Consultar resultado

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

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

Asíncrono
Un 200 de Crear tarea solo significa que la tarea fue aceptada — no que haya terminado. Sondea este endpoint hasta que state sea success o fail. Las tareas fallidas no se facturan.

Endpoints

ModeloTareamodel 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
campos input
promptstringobligatorio

Text description of the image to generate

aspect_ratioenum<string>obligatorio

Width-height ratio determining visual form

qualityenum<string>obligatorio

Medium for balanced output; high for detailed

Ejemplo
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
campos input
input_urlsarray<string>obligatorio

Input image file URLs (max 16 URLs)

promptstringobligatorio

Text description of desired image generation or edit

aspect_ratioenum<string>obligatorio

Width-height ratio of the image

qualityenum<string>obligatorio

Quality: medium for balanced, high for detailed

Ejemplo
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
campos input
promptstringobligatorio

Text prompt for image generation (max 20000 chars)

aspect_ratioenum<string>opcional

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

resolutionenum<string>opcional

Output image resolution

Ejemplo
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
campos input
promptstringobligatorio

Text prompt for image generation, up to 20000 characters

input_urlsarray<string>obligatorio

Array of input image URLs (max 16 images)

aspect_ratioenum<string>opcional

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

resolutionenum<string>opcional

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

Ejemplo
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"
  }
}'