Documentation

Démarrage Rapide

Commencez avec l'API de Restauration de Photos en quelques minutes seulement. Ce guide vous accompagnera à travers les étapes essentielles pour intégrer la restauration de photos alimentée par l'IA dans votre application.

Prérequis

Avant de commencer, assurez-vous d'avoir :

  • Compte : Inscrivez-vous sur restoreoldphotos.online
  • Clé API : Créez une clé API dans les paramètres
  • Crédits : Achetez des crédits de restauration de photos
  • URL d'image : Une URL d'image publiquement accessible pour les tests

Étape 1 : Obtenez Votre Clé API

  1. Visitez restoreoldphotos.online
  2. Connectez-vous avec votre compte Google
  3. Naviguez vers Paramètres > Clés API
  4. Cliquez sur le bouton "Créer une nouvelle clé API"
  5. Entrez un nom de clé (ex : "Mon Application")
  6. Après avoir créé la clé, copiez la valeur complète de la clé (gardez-la en sécurité !)

Format de la Clé API

  • Commence par sk-
  • Contient des caractères générés aléatoirement
  • Exemple : sk-abc123def456ghi789...

Étape 2 : Effectuez Votre Premier Appel API

Utilisation de cURL

curl -X POST https://restoreoldphotos.online/api/api-call/photo-restore \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "imageUrl": "https://example.com/old-photo.jpg"
  }'

Utilisation de JavaScript

async function restorePhoto(imageUrl, apiKey) {
  try {
    const response = await fetch('https://restoreoldphotos.online/api/api-call/photo-restore', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${apiKey}`
      },
      body: JSON.stringify({
        imageUrl: imageUrl
      })
    });
 
    if (!response.ok) {
      throw new Error(`API Error: ${response.status}`);
    }
 
    const result = await response.json();
    return result.output; // URL ou chaîne base64
  } catch (error) {
    console.error('Error:', error);
    throw error;
  }
}
 
// Utilisation
const restoredImage = await restorePhoto(
  'https://example.com/old-photo.jpg',
  'your-api-key-here'
);
console.log('Restored image:', restoredImage);

Étape 3 : Gérez la Réponse

L'API retourne une réponse JSON avec l'image restaurée :

{
  "output": "https://replicate.delivery/pbxt/xxx.png"
}

Ou au format base64 :

{
  "output": "data:image/png;base64,iVBORw0KGgoAAAANS..."
}

Le champ output contient :

  • URL d'image : Lien direct vers l'image restaurée
  • Chaîne base64 : Données d'image encodées en base64

Étape 4 : Affichez le Résultat

En HTML

<img src="https://replicate.delivery/pbxt/xxx.png" alt="Photo Restaurée" />

En JavaScript

// Pour URL ou base64
const img = document.createElement('img');
img.src = restoredImage; // champ output de la réponse API
document.body.appendChild(img);

Étape 5 : Gestion des Erreurs

Implémentez toujours une gestion d'erreur appropriée :

try {
  const restoredImage = await restorePhoto(imageUrl, apiKey);
  // Gérez le succès
} catch (error) {
  if (error.message.includes('401')) {
    console.error('Clé API invalide');
  } else if (error.message.includes('402')) {
    console.error('Crédits insuffisants');
  } else if (error.message.includes('429')) {
    console.error('Limite de taux dépassée');
  } else {
    console.error('Erreur API:', error.message);
  }
}

Gestion des Clés API

Gestion des Clés dans les Paramètres

  • Affichez la liste de toutes les clés API
  • Affichez les statistiques d'utilisation des clés
  • Désactivez ou supprimez les clés inutilisées
  • Affichez la dernière utilisation des clés

Meilleures Pratiques de Sécurité

  • Ne codez jamais les clés API en dur dans le code côté client
  • Stockez les clés en utilisant des variables d'environnement
  • Faites tourner les clés API régulièrement
  • Utilisez des clés différentes pour différents environnements

Exemple de Variables d'Environnement

# fichier .env
PHOTO_RESTORE_API_KEY=sk-your-api-key-here
// Utilisez dans le code
const apiKey = process.env.PHOTO_RESTORE_API_KEY;