Documentation

API de Restauration de Photos

Restaurer d'anciennes photos en utilisant la technologie IA

L'API de Restauration de Photos vous permet de restaurer d'anciennes photos endommagées en utilisant une technologie IA avancée. Ce point de terminaison traite les images et retourne une version restaurée. Découvrez la puissante fonctionnalité de restauration de photos IA de Restore Old Photos.

Point de Terminaison

POST /api/api-call/photo-restore

Authentification

Nécessite une clé API valide dans l'en-tête Authorization :

Authorization: Bearer YOUR_API_KEY

Requête

En-têtes

En-têteRequisDescription
Content-TypeOuiDoit être application/json
AuthorizationOuiVotre clé API au format Bearer YOUR_API_KEY

Paramètres du Corps

ParamètreTypeRequisDescription
imageUrlstringOuiURL de l'image à restaurer (doit être accessible publiquement)

Exemple de Requête

{
  "imageUrl": "https://example.com/old-photo.jpg"
}

Réponse

Réponse de Succès (200)

L'API retourne l'URL ou la chaîne base64 de l'image restaurée. La plateforme gère automatiquement tous les types de flux, et le champ output est toujours une URL ou une chaîne base64.

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

ou :

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

Description :

  • La sortie est l'URL de l'image (recommandé) ou la chaîne base64 (pour les images partielles/fichiers volumineux)
  • Aucun objet de flux n'est retourné, les utilisateurs peuvent l'utiliser directement pour les balises img ou le téléchargement

Réponses d'Erreur

400 Bad Request

{
  "message": "Entrée invalide"
}

401 Unauthorized

{
  "message": "Clé API invalide ou expirée"
}

402 Payment Required

{
  "message": "Crédits insuffisants"
}

500 Internal Server Error

{
  "message": "Erreur de service"
}

429 Too Many Requests

{
  "message": "Limite de taux dépassée. Veuillez réessayer plus tard."
}

Limites de Taux

  • Limite : 100 requêtes par heure par clé API
  • Fenêtre : 60 minutes
  • Réponse : 429 Too Many Requests quand dépassé

Exemples d'Utilisation

JavaScript/Node.js

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) {
      const error = await response.text();
      throw new Error(`Erreur API : ${response.status} - ${error}`);
    }
 
    const result = await response.json();
    
    // La sortie est toujours une chaîne (URL ou base64)
    if (result.output.startsWith('data:image')) {
      // Données d'image base64
      return result.output;
    } else if (result.output.startsWith('http')) {
      // URL d'image
      return result.output;
    } else {
      throw new Error('Format de sortie invalide');
    }
  } catch (error) {
    console.error('Erreur lors de la restauration de la photo :', error);
    throw error;
  }
}
 
// Utilisation
const restoredImage = await restorePhoto(
  'https://example.com/old-photo.jpg',
  'your-api-key-here'
);
console.log('Image restaurée :', restoredImage);

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"
  }'

Exigences d'Image

  • Format : JPG, PNG, WebP
  • Taille : Maximum 5MB
  • Accessibilité : L'URL de l'image doit être accessible publiquement
  • Contenu : Doit être un fichier image valide

Temps de Traitement

  • Typique : 10-30 secondes
  • Images volumineuses : Peut prendre jusqu'à 60 secondes

Crédits

  • Coût : 1 crédit par restauration
  • Déduction : Les crédits sont déduits après traitement réussi

Bonnes Pratiques

  1. Qualité d'image : Utilisez des images de haute qualité pour de meilleurs résultats
  2. Gestion d'erreurs : Implémentez toujours une gestion d'erreurs appropriée
  3. Gestion des crédits : Surveillez régulièrement votre solde de crédits
  4. Traitement de sortie : La sortie est toujours une chaîne, aucun traitement de flux nécessaire

Dépannage

Problèmes Courants

401 Unauthorized

  • Vérifiez que votre clé API est correcte
  • Assurez-vous que la clé API est active et non expirée

402 Payment Required

  • Ajoutez des crédits à votre compte
  • Vérifiez votre solde de crédits actuel

400 Bad Request

  • Vérifiez que l'imageUrl est une URL valide et accessible
  • Assurez-vous que le format d'image est pris en charge

Format de Sortie Invalide

  • La sortie doit toujours être une chaîne (URL ou base64)
  • Vérifiez si la réponse API contient le champ de sortie attendu

429 Too Many Requests

  • Vous avez dépassé la limite de taux de 100 requêtes par heure
  • Attendez que la fenêtre de limite de taux se réinitialise avant de faire plus de requêtes

Support

Si vous rencontrez des problèmes non couverts ici, veuillez contacter notre équipe de support.