Qu'est-ce qu'une API de colorisation de photos ?

C'est un endpoint HTTP qui reçoit une image en noir et blanc et renvoie une version colorisée. Le modèle lit le contenu de la photographie — visages, vêtements, végétation, ciel, matières — et prédit des couleurs cohérentes : vous obtenez un résultat naturel sans indiquer de palette.

Les couleurs sont-elles exactes ?

Elles sont plausibles, pas vérifiées. Le modèle ignore de quelle couleur était réellement une veste donnée en 1953 ; il produit la colorisation la plus probable au vu de tout ce qui est visible dans le cadre. Les carnations, la végétation et le ciel sont généralement convaincants car ils varient dans une plage étroite ; les vêtements, les surfaces peintes et les autres objets à couleur arbitraire relèvent de suppositions éclairées. Pour du matériel historique, présentez le résultat comme une interprétation.

Combien coûte la colorisation ?

Deux crédits par appel réussi. Starter inclut 400 crédits par mois à 9,99 $ et Pro en inclut 1 400 à 29,99 $, les crédits non utilisés étant reportés tant que l'abonnement est actif.

Comment intégrer l'API de colorisation à mon application ?

Créez une clé d'API dans votre compte ImgGen, puis envoyez en POST un formulaire multipart avec un champ image vers https://app.imggen.ai/v1/colorize-photo, en vous authentifiant avec un en-tête Authorization: Bearer. Décodez le champ image en base64 de la réponse JSON et écrivez-le là où vous stockez vos fichiers. Des exemples en cURL, Node.js et Python figurent sur cette page.

Quelle différence avec l'API de restauration ?

Cet endpoint est conçu pour ajouter de la couleur et peut en option réparer des déchirures. L'endpoint de restauration est conçu pour réparer les dommages et peut en option ajouter de la couleur. Si la photographie est surtout abîmée, utilisez la restauration ; si elle est simplement en noir et blanc, utilisez celui-ci.

Quels formats et quelles tailles sont pris en charge ?

L'API accepte les fichiers JPEG (JPG), PNG et WebP jusqu'à 25 Mo par image. Les résultats sont renvoyés sous forme d'image encodée en base64 dans la réponse JSON.

Stockez-vous les images que j'envoie ?

Non. L'API est sans état : elle ne crée aucun projet, n'enregistre aucun fichier et ne conserve pas votre image. Votre envoi est écrit dans un objet temporaire, traité, puis supprimé dès que la réponse est renvoyée. La seule chose conservée est un journal d'utilisation indiquant qu'un appel a eu lieu et combien de crédits il a coûté. Vos images ne servent jamais à entraîner des modèles.

2 crédits par appel

API de colorisation de photos

Transformez des photographies en noir et blanc en images aux couleurs naturelles avec une seule requête. Réparation des déchirures en option dans le même appel, et aucun choix de couleur manuel à aucun moment.

REST · JSON
Sans filigrane
Rien n'est stocké

Obtenir votre clé d'API Lire la documentation

endpoint

POST /v1/colorize-photo

URL de base: https://app.imggen.ai
Auth: Authorization: Bearer sk_live_…
Coût: 2 crédits
Entrée: JPEG (JPG), PNG and WebP · max 25 MB

01 — Aperçu

Qu'est-ce que l'API de colorisation de photos ?

L'API de colorisation ImgGen AI est un endpoint REST qui ajoute une couleur réaliste aux images en noir et blanc ou en niveaux de gris. Le modèle déduit des couleurs plausibles pour la peau, les vêtements, la végétation, le ciel et les matières à partir du contenu même de l'image : aucune palette de référence ni sélection manuelle n'est nécessaire. Le résultat colorisé est renvoyé dans la même réponse.

C'est l'un des sept endpoints de l'API d'édition d'images ImgGen AI, qui partagent tous une seule clé d'API, une seule URL de base et le même format de requête et de réponse. Si vous avez aussi besoin de cette fonction dans un navigateur plutôt que depuis du code, le même modèle d'IA anime l'outil Colorize Photo.

02 — Requête

Paramètres de la requête

Envoyez une requête POST vers https://app.imggen.ai/v1/colorize-photo, authentifiée avec une clé d'API dans l'en-tête Authorization.

Paramètres acceptés par cet endpoint
Paramètre	Type	Obligatoire	Par défaut	Description
image	file	OBLIGATOIRE	—	Répare rayures et déchirures pendant la colorisation.
removeTears	boolean	facultatif	false	Repair scratches and tears while colorizing.

03 — Intégration

Comment intégrer l'API pour coloriser une photo ?

Créez une clé d'API dans votre compte ImgGen, enregistrez-la comme variable d'environnement et appelez l'endpoint. Voici la même requête en cURL, Node.js et Python.

curl --request POST \
  --url 'https://app.imggen.ai/v1/colorize-photo' \
  --header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
  --form image=@/path/to/photo.jpg \
  --form removeTears=false

import fs from 'node:fs';

const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('removeTears', 'false');

const res = await fetch('https://app.imggen.ai/v1/colorize-photo', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
  body: form,
});

const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));

import base64, os, requests

with open("photo.jpg", "rb") as f:
    res = requests.post(
        "https://app.imggen.ai/v1/colorize-photo",
        headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
        files={"image": f},
    data={"removeTears": "false"},
    )

data = res.json()
with open("result.png", "wb") as out:
    out.write(base64.b64decode(data["image"]))

04 — Réponse

Réponse

Un appel réussi renvoie du JSON. Le résultat est encodé en base64 — décodez-le avant de l'écrire sur disque ou dans votre stockage objet. Chaque réponse réussie porte aussi un en-tête X-Credit-Remaining avec votre solde après l'appel.

{
  "success": true,
  "message": "Image colorized successfully",
  "image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}

05 — Limites

Limites et comportements à connaître

L'endpoint accepte JPEG (JPG), PNG et WebP avec une taille de fichier maximale de 25 Mo, et répond de façon synchrone en moins de 60 secondes : aucun job à interroger, aucun webhook à configurer.

La couleur est déduite, pas retrouvée

Le modèle prédit une couleur plausible à partir du contenu de l'image. Il produit une interprétation convaincante, pas une vérité historiquement vérifiée — cela vaut la peine de le dire clairement si vous montrez les résultats à vos utilisateurs.

Réparez pendant la colorisation

Mettez removeTears=true pour corriger rayures et dommages physiques dans la même passe, sans second appel à l'endpoint de restauration.

Images déjà en couleur

L'endpoint est conçu pour des entrées en niveaux de gris. Envoyer une image qui a déjà de la couleur n'a pas d'intérêt — utilisez l'endpoint de restauration si l'objectif est de réparer.

06 — En production

À quoi sert l'API pour coloriser une photo ?

Là où les équipes mettent cet endpoint en production pour traiter des images par programmation, à grande échelle.

Produits d'histoire familiale

Laissez vos utilisateurs coloriser des photographies héritées dans votre application, comme option payante ou fonctionnalité d'engagement.

Presse et édition

Produisez des versions colorisées de photographies d'archives pour des reportages et des rétrospectives, clairement présentées comme des interprétations.

Traitement d'archives en masse

Générez des copies de consultation en couleur sur toute une collection en niveaux de gris tout en préservant les originaux intacts.

Services commémoratifs et cadeaux

Colorisez et réparez automatiquement la photographie envoyée par un client dans le cadre d'un flux de commande.

07 — Coût

Combien coûte l'API pour coloriser une photo ?

Chaque appel réussi coûte 2 crédits : votre coût réel par image dépend donc du forfait que vous avez. Les crédits proviennent de votre forfait et sont partagés entre tous les endpoints et l'éditeur web, vous n'achetez donc pas un quota séparé par outil. Un appel qui échoue est remboursé automatiquement. Voir tous les détails sur la page tarifs.

Forfaits ImgGen AI et accès à l'API
Forfait	Prix	Crédits	API
Free	$0	50 crédits gratuits en une fois	Pas d'accès à l'API
Starter	$9.99 / month	400 crédits / mois	Accès à l'API inclus
Pro	$29.99 / month	1 400 crédits / mois	Accès à l'API + support prioritaire
Enterprise	Custom	Volume sur mesure	Infrastructure dédiée

Coûts en crédits et limites vérifiés pour la dernière fois le 2026-08-27.

08 — Associés

Les équipes qui utilisent l'API pour coloriser une photo se tournent ensuite généralement vers ceux-ci.

→API de restauration de photos →API d'agrandissement d'images Colorize Photo (outil web)Tous les endpoints de l'API

Également disponibles : Suppression d'arrière-plan, Suppression de filigrane, Suppression de texte, Génération d'images.

FAQ

FAQ sur l'API de colorisation de photos

: C'est un endpoint HTTP qui reçoit une image en noir et blanc et renvoie une version colorisée. Le modèle lit le contenu de la photographie — visages, vêtements, végétation, ciel, matières — et prédit des couleurs cohérentes : vous obtenez un résultat naturel sans indiquer de palette.
: Elles sont plausibles, pas vérifiées. Le modèle ignore de quelle couleur était réellement une veste donnée en 1953 ; il produit la colorisation la plus probable au vu de tout ce qui est visible dans le cadre. Les carnations, la végétation et le ciel sont généralement convaincants car ils varient dans une plage étroite ; les vêtements, les surfaces peintes et les autres objets à couleur arbitraire relèvent de suppositions éclairées. Pour du matériel historique, présentez le résultat comme une interprétation.
: Deux crédits par appel réussi. Starter inclut 400 crédits par mois à 9,99 $ et Pro en inclut 1 400 à 29,99 $, les crédits non utilisés étant reportés tant que l'abonnement est actif.
: Créez une clé d'API dans votre compte ImgGen, puis envoyez en POST un formulaire multipart avec un champ image vers https://app.imggen.ai/v1/colorize-photo, en vous authentifiant avec un en-tête Authorization: Bearer. Décodez le champ image en base64 de la réponse JSON et écrivez-le là où vous stockez vos fichiers. Des exemples en cURL, Node.js et Python figurent sur cette page.
: Cet endpoint est conçu pour ajouter de la couleur et peut en option réparer des déchirures. L'endpoint de restauration est conçu pour réparer les dommages et peut en option ajouter de la couleur. Si la photographie est surtout abîmée, utilisez la restauration ; si elle est simplement en noir et blanc, utilisez celui-ci.
: L'API accepte les fichiers JPEG (JPG), PNG et WebP jusqu'à 25 Mo par image. Les résultats sont renvoyés sous forme d'image encodée en base64 dans la réponse JSON.
: Non. L'API est sans état : elle ne crée aucun projet, n'enregistre aucun fichier et ne conserve pas votre image. Votre envoi est écrit dans un objet temporaire, traité, puis supprimé dès que la réponse est renvoyée. La seule chose conservée est un journal d'utilisation indiquant qu'un appel a eu lieu et combien de crédits il a coûté. Vos images ne servent jamais à entraîner des modèles.

Commencer

Commencez à appeler l'API de colorisation de photos

Une seule clé débloque les sept endpoints. Sans filigrane, avec des droits commerciaux complets, et rien de ce que vous envoyez n'est conservé une fois la réponse renvoyée.

Obtenir votre clé d'API