Editar imagen

Descripción generalCopy Anchor Link

Crea una imagen editada o extendida dada una imagen original y un prompt.

El endpoint admite ambos flujos:

• el flujo de carga multipart/form-data compatible con OpenAI documentado abajo
• solicitudes JSON que proporcionan image_url, image_urls o referencias oficiales images para familias de imagen a imagen compatibles

Cuerpo de la solicitudCopy Anchor Link

Tiempo de espera de solicitudes síncronas: algunas solicitudes de imagen devuelven la imagen final inline y esperan a que termine la generación. Las solicitudes de alta resolución o alta calidad pueden tardar cerca de un minuto o más, así que configura el timeout de tu cliente HTTP en al menos 120s. Si la respuesta de creación incluye status: "pending", task_id o poll_url, sigue el poll_url devuelto en su lugar.

URLs de imagen remotas: cuando se necesita entrada multipart, TokenLab descarga JSON image_url, image_urls o images[].image_url y envía los bytes como partes multipart image. Las URLs deben ser públicas http/https, sin credenciales incrustadas ni fragmentos, y no deben resolver a localhost ni a rangos IP privados o reservados; cada redirección se valida de nuevo. El contenido descargado debe ser una imagen PNG, JPEG o WebP real. Límites: 50 MiB por imagen, 200 MiB en total para imágenes descargadas por URL en una solicitud, timeout de 30s y hasta 3 redirecciones.

Una solicitud JSON debe incluir exactamente uno de image_url, image_urls o images. Cada objeto images[] debe contener solo uno de image_url o file_id. El límite total de 200 MiB incluye todas las imágenes de origen y la máscara.

RespuestaCopy Anchor Link

Respuesta de tarea asíncronaCopy Anchor Link

Usa async: true con gpt-image-2 o modelos de edición oficiales FLUX/BFL para crear una tarea en lugar de esperar la imagen editada en la solicitud. La respuesta incluye status: "pending", task_id y poll_url. Consulta /v1/tasks/{task_id} hasta que la tarea llegue a completed o failed.

Las tareas asíncronas de edición solo devuelven las URL finales. Si necesitas datos de imagen b64_json sin procesar, usa una solicitud síncrona.

Al crear la tarea puede reservarse el importe estimado. Las tareas completadas se cobran por uso real; las fallidas o vencidas liberan o reembolsan la reserva.

curl -X POST "https://api.tokenlab.sh/v1/images/edits" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=gpt-image-2" \
  -F "image=@sunlit_lounge.png" \
  -F "mask=@mask.png" \
  -F "prompt=A sunlit indoor lounge area with a pool" \
  -F "n=1" \
  -F "size=1024x1024"

{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    }
  ]
}

NotasCopy Anchor Link

{
  "model": "hy-image-v3.5-preview",
  "prompt": "Change the table to pale blue",
  "image_url": "https://example.com/reference.png",
  "size": "1024x1024",
  "n": 1,
  "response_format": "url"
}