Referencia de API para Desarrolladores

Notas para desarrolladores de ImageToURL. Las subidas públicas con clave API aún no están activas; usa el cargador del sitio web para enlaces de producción hoy.

Primeros Pasos

La API de ImageToURL está organizada en torno a REST. Nuestra API tiene URLs predecibles orientadas a recursos, devuelve respuestas codificadas en JSON y utiliza códigos de respuesta HTTP estándar, autenticación y verbos.

URL Base Producción
https://imagetourl.cloud/api

Autenticación

La API de ImageToURL utiliza claves API para autenticar las solicitudes. Puedes ver y gestionar tus claves API en el Panel de Control. Tus claves API tienen muchos privilegios, así que asegúrate de mantenerlas seguras.

Public API-key uploads are not live yet. The current upload route is used by the ImageToURL website uploader and requires a same-site browser request from imagetourl.cloud.

Subir una Imagen

POST /api/upload

Sube desde el sitio web para recibir una URL con caché en CDN. Las subidas de visitantes caducan; los usuarios con sesión pueden elegir un enlace permanente antes de subir.

Parámetros

Nombre Tipo Descripción
file binary El archivo de imagen (PNG, JPG, WebP) hasta 50 MB.
expires_in string Tiempo de vida opcional en segundos.
adblock string Nombre de la carpeta de destino.
Ejemplo de Respuesta 200 OK
{ "success": true, "data": { "id": "img_ab12cd34", "url": "https://imagetourl.cloud/ab12cd34.png", "filename": "my_image.png", "size": 102488, "mimetype": "image/png", "created_at": "2026-07-06T10:00:00.000Z" } }