Référence API développeur

Notes développeur pour ImageToURL. Les téléversements publics avec clé API ne sont pas encore actifs; utilisez le téléverseur du site pour les liens de production aujourd'hui.

Démarrage rapide

L'API ImageToURL est organisée autour de REST. Notre API utilise des URL prévisibles orientées ressources, renvoie des réponses encodées en JSON et utilise les codes de réponse HTTP standard, l'authentification et les verbes HTTP.

URL de base Production

https://imagetourl.cloud/api

Authentification

L'API ImageToURL utilise des clés API pour authentifier les requêtes. Vous pouvez consulter et gérer vos clés API dans le tableau de bord. Vos clés API disposent de nombreux privilèges, veillez donc à les garder en sécurité !

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.

Téléverser une image

POST /api/upload

Téléversez depuis le site web pour recevoir une URL mise en cache par CDN. Les téléversements visiteurs expirent; les utilisateurs connectés peuvent choisir un lien permanent avant le téléversement.

Paramètres

Nom	Type	Description
file	binary	Le fichier image (PNG, JPG, WebP) jusqu'à 50 Mo.
expires_in	string	Durée de vie optionnelle en secondes.
adblock	string	Nom du dossier de destination.

Exemple de réponse 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"
  }
}