Une API pour agrandir une image, sans compte ni clé

Ce qu'exige une API d'image classique, et ce qu'exige Airpic

Le parcours habituel pour obtenir l'accès à une API de traitement d'image ressemble à ceci : création d'un compte avec e-mail et mot de passe, confirmation par courrier, parfois une vérification d'identité ou de société, génération d'une clé secrète dans un tableau de bord, saisie d'une carte bancaire, puis choix d'un plan. Le plan fixe un quota mensuel de requêtes, et ce qui n'est pas consommé à la fin du mois est perdu. Avant la première image traitée, vous avez déjà donné un e-mail, un numéro de carte et accepté une facturation récurrente.

Airpic fonctionne autrement, et la différence tient en une phrase : le code de crédits est la clé. Quand vous achetez un pack sur le site, vous recevez un code au format 0TK suivi de douze caractères. Sur le site, ce code est conservé dans votre navigateur et débité à chaque téléchargement complet. Dans l'API, vous envoyez exactement le même code dans l'en-tête HTTP d'autorisation, comme jeton Bearer. Il n'y a rien d'autre à créer : pas de compte, pas de clé séparée, pas de tableau de bord, pas de plan à choisir, pas de SDK à installer.

Cette absence de compte n'est pas un oubli, c'est le fonctionnement de tout le service. Ni e-mail ni mot de passe : le fichier entre, il est traité sur un GPU dans l'Union européenne et il est supprimé au plus une heure après le téléchargement, un jour si vous ne téléchargez pas. Aucun modèle n'est entraîné avec vos images. Ce qui vaut pour le site vaut pour l'API, puisque ce sont les mêmes serveurs et les mêmes règles ; nous les détaillons dans que deviennent vos photos sur un site d'IA.

La contrepartie est à connaître : un code au porteur se comporte comme de l'argent liquide. Toute personne qui le possède peut dépenser les crédits qu'il contient. Gardez-le côté serveur, dans une variable d'environnement ou un gestionnaire de secrets, jamais dans une page web, une application mobile ou un dépôt de code public. Si vous travaillez à plusieurs, achetez un code par projet : la perte d'un code ne compromet alors qu'un seul budget.

API upscale image, détourage, compression, vidéo : ce que vous pouvez appeler

L'API expose les mêmes outils que le site, avec les mêmes réglages. Il n'existe pas de version « allégée » réservée aux développeurs : une requête API et un clic sur le site arrivent sur le même moteur, avec les mêmes limites de taille et la même qualité de sortie. Chaque travail se crée en envoyant le fichier, le nom de l'outil et un petit objet JSON d'options.

Pour agrandir une image, les options reprennent celles de l'interface : le facteur (×2, ×4, ×8, ×16 ou le mode maximal par mosaïque, jusqu'à 600 mégapixels), le style de rendu (netteté ou rendu pictural) et l'amélioration des visages. Les facteurs ×2 et ×4 consomment un crédit standard ; ×8, ×16 et le mode maximal, un crédit grand format, pensé pour l'impression. Les dessins au trait, mangas et illustrations passent par l'outil pour agrandir une image anime ou un dessin, avec un facteur 2 ou 4.

Pour supprimer le fond d'une photo sans inscription, un seul paramètre : le fond de sortie, transparent, blanc, noir ou n'importe quelle couleur en hexadécimal. Les bords sont calculés à la résolution complète de l'image, cheveux compris, sans halo, ce qui compte si vous détourez des centaines de photos produit pour une boutique en ligne ou une marketplace. Pour compresser une image, vous passez le format de sortie (JPEG, WebP, AVIF ou PNG), une qualité, un poids cible en kilo-octets, un côté maximal en pixels et, si vous voulez, la suppression des métadonnées en conservant le profil ICC ; cet outil tourne sur CPU, répond en quelques secondes et reste entièrement gratuit, téléchargement compris.

Les autres outils d'image suivent la même logique : la colorisation avec sa variante naturelle ou vive et son intensité, la réduction de bruit et la correction de flou avec leur intensité (et, pour le flou, le type : mouvement ou mise au point), la restauration de photos anciennes avec reconstruction des visages, recolorisation optionnelle, facteur 1 ou 2 et photos de référence de la même personne, et la suppression d'objets, qui attend en second champ un masque PNG de la taille de l'image, peint en opaque sur les zones à effacer. Le format de sortie (PNG, JPG ou WebP) et sa qualité sont communs à tous les outils, sauf la compression qui a les siens. En entrée : JPG, PNG (y compris 16 bits et avec transparence), WebP, TIFF, HEIC et AVIF ; l'orientation EXIF est appliquée et le profil ICC conservé.

Côté vidéo, trois outils : transcrire une vidéo en texte (99 langues, code de langue ou détection automatique, option de version anglaise, ZIP avec TXT, SRT, VTT et JSON), la conversion d'une vidéo en document (DOCX, PDF ou Markdown, avec résumé court, moyen ou long, points clés et chapitres horodatés) et la création de shorts (1 à 5 clips verticaux de 15 à 60 secondes, sous-titres mot à mot). Les fichiers volumineux, au-delà de 90 Mo environ, ne passent pas en une seule requête : vous ouvrez d'abord un envoi par morceaux, vous envoyez chaque partie, vous clôturez l'envoi et vous créez le travail avec l'identifiant obtenu. Cela vaut pour une conférence de deux heures comme pour un rush de tournage.

Les noms exacts des champs, les valeurs acceptées et les limites par outil (32 mégapixels pour la plupart des outils d'image, 25 pour la correction de flou, 20 pour la restauration, 3 heures pour la transcription) sont tenus à jour sur la page developers du site, à l'adresse airpic.app/developers. Nous ne les recopions pas ici volontairement : un article vieillit, cette page non.

Une API d'image IA en paiement à l'usage : ce qui est facturé, ce qui ne l'est pas

Le principe est le même que sur le site : traiter est gratuit, télécharger le fichier complet coûte un crédit. Quand un travail se termine, la réponse contient deux adresses. La première renvoie un aperçu réduit à 1600 pixels de côté au maximum, gratuit et sans jeton : il sert à vérifier que le résultat est bon avant de dépenser quoi que ce soit, exactement comme le comparateur du site (nous expliquons cette logique dans voir le résultat avant de payer). La seconde renvoie le fichier complet et exige le code en en-tête d'autorisation.

Le premier téléchargement d'un travail débite un crédit du bon type sur le code : standard, grand format ou vidéo. Les téléchargements suivants du même travail sont gratuits, donc un script qui réessaie après une coupure réseau ne paie pas deux fois. Si le code n'a plus de crédit du type demandé, l'API répond par un code HTTP 402 en précisant quel type manque, et rien n'est débité. Un travail qui échoue n'est jamais facturé. Le téléchargement gratuit du mois, accordé par adresse IP, s'applique aussi aux appels API : votre premier test ne vous coûtera rien.

Les crédits n'expirent jamais. C'est la différence pratique avec un plan mensuel : un pack acheté en janvier pour un projet ponctuel sert encore en septembre pour le suivant, sans abonnement à résilier entre les deux. Le pack Imprimerie 100 + API est celui qui porte explicitement la mention API, parce qu'il regroupe 100 crédits grand format, le cas typique des flux automatisés vers l'impression ; mais n'importe quel pack, y compris le plus petit, fournit un code utilisable dans l'API. Le détail des packs et leur prix du moment sont sur la page de l'outil et dans pourquoi Airpic ; nous ne les écrivons pas ici pour ne pas publier un chiffre périmé.

Pour suivre votre consommation, l'API propose une adresse de consultation du solde : vous lui passez le code, elle renvoie le nombre de crédits standard, grand format et vidéo restants. C'est le seul « tableau de bord » qui existe, et il suffit pour alerter votre script quand le solde descend sous un seuil.

Les limites, sans enjoliver : quota horaire, plafond GPU, démarrage à froid

Une API sans compte ne peut pas distinguer ses utilisateurs autrement que par leur adresse IP, et les limites sont donc posées là. 20 travaux par heure et par adresse IP : au-delà, les créations de travail sont refusées jusqu'à l'heure suivante. Pour un flux régulier plus important, écrivez-nous avec votre code et nous relevons le plafond ; pour un besoin ponctuel, répartissez simplement les envois dans le temps. Les GPU sont partagés entre tous les utilisateurs du site et de l'API : gardez au plus deux travaux en cours à la fois, et attendez la fin de l'un pour envoyer le suivant.

Il existe aussi un plafond quotidien de temps GPU pour l'ensemble du service. Il protège le coût de fonctionnement et il est dimensionné pour ne pas être atteint un jour normal ; s'il l'est, la création de travail renvoie une erreur explicite et rien n'est facturé. Un script sérieux doit la traiter comme une erreur temporaire : attendre, puis réessayer, plutôt que de boucler.

Le point qui surprend le plus les développeurs est le démarrage à froid. Les moteurs ne tournent pas en permanence : quand personne n'a utilisé un outil depuis quelques minutes, le premier travail doit d'abord réveiller un GPU et charger le modèle, ce qui ajoute de 60 à 90 secondes la première fois. Les travaux suivants, tant que le moteur est chaud, se font en quelques secondes. Dans nos mesures du 19 septembre 2026, une photo de 320 × 240 px agrandie ×4 en 1280 × 960 px a pris 5 secondes sur un moteur chaud ; le 3 septembre 2026, avec des photos de 0,3 à 1 mégapixel, le ×4 a demandé entre 6 et 9 secondes, et environ 17 secondes avec l'amélioration des visages. Un ×16 sur une grande image peut prendre plusieurs minutes. Interrogez l'état toutes les une à deux secondes, pas plus vite, et prévoyez un délai d'attente de plusieurs minutes avant de déclarer un travail perdu.

Conséquence honnête : cette API n'est pas faite pour le temps réel. Si votre application doit afficher une image agrandie pendant que l'utilisateur attend sur une page, le premier appel de la journée sera trop lent. Elle convient à tout ce qui s'exécute en arrière-plan : une file de traitement de nuit pour un catalogue, un déclencheur à l'ajout d'un fichier dans un dossier, un bouton « préparer pour l'impression » qui prévient que le résultat arrive par e-mail. Autre cas où elle ne sert à rien : agrandir ce qui n'existe pas. Un logo de 40 pixels de haut ou une vignette WhatsApp recompressée dix fois donneront un résultat propre mais pauvre, parce que le modèle n'invente pas de détail fiable à partir de rien ; nous le montrons dans agrandir un logo pixelisé. Vérifiez toujours l'aperçu gratuit avant de télécharger.

Un exemple minimal en trois appels : envoyer, interroger, télécharger

Sans écrire une ligne de code, voici le déroulement complet d'un agrandissement par l'API, tel qu'il se passe sur le fil.

1. Envoyer. Une requête POST en multipart vers l'adresse de création de travail, avec trois champs : le fichier image, le nom de l'outil (ici l'agrandissement) et un objet JSON d'options, par exemple le facteur ×4 et le style netteté. Vous pouvez ajouter un code de langue pour recevoir les messages d'erreur en français. La réponse arrive tout de suite : un identifiant de travail.
2. Interroger. Une requête GET sur l'adresse d'état du travail, répétée toutes les une à deux secondes. L'état passe de « en file » à « en traitement », puis à « terminé » avec les dimensions du résultat, son poids, son extension, l'adresse de l'aperçu gratuit et celle du fichier complet. En cas d'échec, l'état est « erreur » avec le motif, et rien n'est débité.
3. Télécharger. Une requête GET sur l'adresse du fichier complet, avec l'en-tête Authorization: Bearer suivi de votre code 0TK. Le premier téléchargement débite un crédit ; les suivants du même travail sont gratuits. Enregistrez le fichier : il sera supprimé de nos serveurs au plus une heure plus tard.

C'est tout. Pas de SDK, pas de signature de requête, pas de jeton à rafraîchir : trois appels HTTP que n'importe quel langage sait faire. Les exemples en ligne de commande, prêts à copier, sont sur airpic.app/developers.

Avant d'automatiser, faites le même travail une fois à la main : vous verrez les réglages que vous passerez ensuite en JSON et vous saurez ce que donne votre type d'images. Ouvrez l'outil pour agrandir une image et suivez ces étapes :

1. Déposez une photo représentative de votre lot (JPG, PNG, WebP, TIFF, HEIC ou AVIF). Une carte affiche la miniature, le nom du fichier et les dimensions d'entrée et de sortie, qui changent quand vous modifiez le facteur.
2. Dans le groupe « Usage », laissez « Usage standard » pour un affichage à l'écran (×2 ou ×4), ou choisissez « Pour une impression grand format » et indiquez la largeur et la hauteur en centimètres ainsi que la distance de vision : l'outil recommande le facteur minimal qui suffit. C'est ce facteur que vous mettrez dans vos options.
3. Ouvrez « Réglages avancés » et comparez les deux styles sur votre image : « Netteté extrême » convient aux photos et aux textures fines, « Rendu pictural » aux images déjà très dégradées. Choisissez le « Format de sortie » : PNG sans perte, ou JPG et WebP plus légers.
4. Cochez « Améliorer les visages (IA) » uniquement s'il y a des portraits : cela allonge le traitement (environ 17 secondes au lieu de 6 à 9 dans nos mesures du 3 septembre 2026) et ne sert à rien sur un paysage ou un produit.
5. Cliquez sur « Traiter l'image ». Le résultat s'affiche dans le comparateur avant/après ; utilisez « Voir à 100 % » pour juger le détail à l'échelle réelle. Si cela vous convient, cliquez sur « Télécharger le fichier complet » : ce premier fichier du mois est gratuit. Notez les réglages retenus, ce sont exactement les valeurs à envoyer dans l'objet JSON de l'API.

FAQ

À lire ensuite