Dokumentation

Foto-Restaurierungs-API

Alte Fotos mit KI-Technologie restaurieren

Die Foto-Restaurierungs-API ermöglicht es Ihnen, alte, beschädigte Fotos mit fortschrittlicher KI-Technologie zu restaurieren. Dieser Endpunkt verarbeitet Bilder und gibt eine restaurierte Version zurück. Erleben Sie die leistungsstarke KI-Foto-Restaurierungsfunktion von Restore Old Photos.

Endpunkt

POST /api/api-call/photo-restore

Authentifizierung

Erfordert einen gültigen API-Schlüssel im Authorization-Header:

Authorization: Bearer YOUR_API_KEY

Anfrage

HeaderErforderlichBeschreibung
Content-TypeJaMuss application/json sein
AuthorizationJaIhr API-Schlüssel im Format Bearer YOUR_API_KEY

Body-Parameter

ParameterTypErforderlichBeschreibung
imageUrlstringJaURL des zu restaurierenden Bildes (muss öffentlich zugänglich sein)

Anfrage-Beispiel

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

Antwort

Erfolgsantwort (200)

Die API gibt die URL oder Base64-Zeichenkette des restaurierten Bildes zurück. Die Plattform handhabt automatisch alle Stream-Typen, und das output-Feld ist immer eine URL oder Base64-Zeichenkette.

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

oder:

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

Beschreibung:

  • Die Ausgabe ist die URL des Bildes (empfohlen) oder Base64-Zeichenkette (für Teilbilder/große Dateien)
  • Es wird kein Stream-Objekt zurückgegeben, Benutzer können es direkt für img-Tags oder Downloads verwenden

Fehlerantworten

400 Bad Request

{
  "message": "Ungültige Eingabe"
}

401 Unauthorized

{
  "message": "Ungültiger oder abgelaufener API-Schlüssel"
}

402 Payment Required

{
  "message": "Unzureichende Credits"
}

500 Internal Server Error

{
  "message": "Dienstfehler"
}

429 Too Many Requests

{
  "message": "Rate-Limit überschritten. Bitte versuchen Sie es später erneut."
}

Rate-Limits

  • Limit: 100 Anfragen pro Stunde pro API-Schlüssel
  • Fenster: 60 Minuten
  • Antwort: 429 Too Many Requests bei Überschreitung

Verwendungsbeispiele

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(`API-Fehler: ${response.status} - ${error}`);
    }
 
    const result = await response.json();
    
    // Ausgabe ist immer ein String (URL oder base64)
    if (result.output.startsWith('data:image')) {
      // Base64-Bilddaten
      return result.output;
    } else if (result.output.startsWith('http')) {
      // Bild-URL
      return result.output;
    } else {
      throw new Error('Ungültiges Ausgabeformat');
    }
  } catch (error) {
    console.error('Fehler beim Wiederherstellen des Fotos:', error);
    throw error;
  }
}
 
// Verwendung
const restoredImage = await restorePhoto(
  'https://example.com/old-photo.jpg',
  'your-api-key-here'
);
console.log('Wiederhergestelltes Bild:', 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"
  }'

Bildanforderungen

  • Format: JPG, PNG, WebP
  • Größe: Maximum 5MB
  • Zugänglichkeit: Bild-URL muss öffentlich zugänglich sein
  • Inhalt: Muss eine gültige Bilddatei sein

Verarbeitungszeit

  • Typisch: 10-30 Sekunden
  • Große Bilder: Kann bis zu 60 Sekunden dauern

Credits

  • Kosten: 1 Credit pro Wiederherstellung
  • Abzug: Credits werden nach erfolgreicher Verarbeitung abgezogen

Best Practices

  1. Bildqualität: Verwenden Sie hochwertige Bilder für bessere Ergebnisse
  2. Fehlerbehandlung: Implementieren Sie immer eine angemessene Fehlerbehandlung
  3. Credit-Management: Überwachen Sie regelmäßig Ihren Credit-Saldo
  4. Ausgabeverarbeitung: Ausgabe ist immer ein String, keine Stream-Verarbeitung erforderlich

Fehlerbehebung

Häufige Probleme

401 Unauthorized

  • Überprüfen Sie, ob Ihr API-Schlüssel korrekt ist
  • Stellen Sie sicher, dass der API-Schlüssel aktiv und nicht abgelaufen ist

402 Payment Required

  • Fügen Sie Credits zu Ihrem Konto hinzu
  • Überprüfen Sie Ihren aktuellen Credit-Saldo

400 Bad Request

  • Überprüfen Sie, ob die imageUrl eine gültige, zugängliche URL ist
  • Stellen Sie sicher, dass das Bildformat unterstützt wird

Ungültiges Ausgabeformat

  • Die Ausgabe sollte immer ein String sein (URL oder base64)
  • Überprüfen Sie, ob die API-Antwort das erwartete Ausgabefeld enthält

429 Too Many Requests

  • Sie haben das Rate-Limit von 100 Anfragen pro Stunde überschritten
  • Warten Sie, bis das Rate-Limit-Fenster zurückgesetzt wird, bevor Sie weitere Anfragen stellen

Support

Wenn Sie auf Probleme stoßen, die hier nicht behandelt werden, kontaktieren Sie bitte unser Support-Team.