Crear imagen

Crea una imagen a partir de un prompt

​

Cuerpo de la solicitud

model · string · predeterminado: "dall-e-3"

Modelo a utilizar (p. ej., dall-e-3, flux-pro, midjourney).

prompt · string · requerido

Descripción de texto de la imagen deseada.

n · integer · predeterminado: "1"

Número de imágenes a generar (1-4, según el modelo).

size · string · predeterminado: "1024x1024"

Tamaño de la imagen. Las opciones varían según el modelo:

• DALL-E 3: 1024x1024, 1792x1024, 1024x1792
• Otros modelos: 512x512, 1024x1024, etc.

quality · string · predeterminado: "standard"

Calidad de la imagen (standard o hd). Solo DALL-E 3.

response_format · string · predeterminado: "url"

Formato de respuesta: url o b64_json.

style · string · predeterminado: "vivid"

Estilo para DALL-E 3: vivid o natural.

user · string

Un identificador único para el usuario final.

​

Respuesta

​

Respuesta sincrónica (DALL-E, Flux Schnell, etc.)

created · integer

Marca de tiempo Unix de creación.

data · array

Array de imágenes generadas.

Cada objeto contiene:

• url (string): URL de la imagen generada
• b64_json (string): Imagen codificada en Base64 (si se solicitó)
• revised_prompt (string): El prompt utilizado (DALL-E 3)

​

Respuesta asíncrona (Midjourney, Flux Pro, Ideogram, etc.)

Algunos modelos requieren más tiempo de procesamiento y devuelven una respuesta async:

created · integer

Marca de tiempo Unix de creación.

task_id · string

Identificador único de la tarea para polling.

status · string

Estado inicial: pending.

poll_url · string

URL relativa para consultar los resultados (p. ej., /v1/images/generations/{task_id}).

data · array

Array con datos de marcador de posición. url estará vacío hasta que se complete.

Cuando recibas status: "pending", usa el endpoint Get Image Status para consultar el resultado.

cURL

curl -X POST "https://api.lemondata.cc/v1/images/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "A white cat sitting on a windowsill watching rain",
    "size": "1024x1024",
    "quality": "standard",
    "n": 1
  }'

Synchronous Response

{
  "created": 1706000000,
  "data": [
    {
      "url": "https://...",
      "revised_prompt": "A fluffy white cat with bright eyes sitting peacefully on a wooden windowsill, watching raindrops stream down the glass window..."
    }
  ]
}

​

Modelos disponibles

Model	Type	Features
dall-e-3	Sync	Mejor calidad, mejora de prompts
dall-e-2	Sync	Más rápido, más económico
flux-pro	Async	Fotorrealista, alta calidad
flux-schnell	Sync	Muy rápido
midjourney	Async	Estilo artístico
ideogram-v3	Async	Mejor renderizado de texto
stable-diffusion-3	Sync	Código abierto, personalizable

Los modelos async devuelven status: "pending" y requieren polling. Consulta Get Image Status para saber cómo recuperar los resultados.

​

Manejo de respuestas async

Para modelos async, verifica si la respuesta contiene status: "pending":

import requests
import time

def generate_image(prompt, model="midjourney"):
    # Create image request
    response = requests.post(
        "https://api.lemondata.cc/v1/images/generations",
        headers={"Authorization": "Bearer sk-your-api-key"},
        json={"model": model, "prompt": prompt}
    )
    data = response.json()

    # Check if async
    if data.get("status") == "pending":
        task_id = data["task_id"]
        print(f"Async task started: {task_id}")

        # Poll for result
        while True:
            status_resp = requests.get(
                f"https://api.lemondata.cc/v1/images/generations/{task_id}",
                headers={"Authorization": "Bearer sk-your-api-key"}
            )
            status_data = status_resp.json()

            if status_data["status"] == "completed":
                return status_data["data"][0]["url"]
            elif status_data["status"] == "failed":
                raise Exception(status_data.get("error", "Generation failed"))

            time.sleep(3)
    else:
        # Sync response
        return data["data"][0]["url"]

# Usage
url = generate_image("a beautiful sunset over mountains", model="midjourney")
print(f"Generated image: {url}")