Foto-Restaurierungs-API

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

Header

Body-Parameter

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.