Dokumentation
Erste Schritte/Schnellstart

Schnellstart

Starten Sie in wenigen Minuten mit der Foto-Restaurierungs-API. Diese Anleitung führt Sie durch die wesentlichen Schritte zur Integration der KI-gestützten Foto-Restaurierung in Ihre Anwendung.

Voraussetzungen

Stellen Sie vor dem Start sicher, dass Sie haben:

  • Konto: Registrieren Sie sich bei restoreoldphotos.online
  • API-Schlüssel: Erstellen Sie einen API-Schlüssel in den Einstellungen
  • Credits: Kaufen Sie Foto-Restaurierungs-Credits
  • Bild-URL: Eine öffentlich zugängliche Bild-URL für Tests

Schritt 1: Holen Sie sich Ihren API-Schlüssel

  1. Besuchen Sie restoreoldphotos.online
  2. Melden Sie sich mit Ihrem Google-Konto an
  3. Navigieren Sie zu Einstellungen > API-Schlüssel
  4. Klicken Sie auf den "Neuen API-Schlüssel erstellen" Button
  5. Geben Sie einen Schlüsselnamen ein (z.B. "Meine App")
  6. Nach der Erstellung kopieren Sie den vollständigen Schlüsselwert (bewahren Sie ihn sicher auf!)

API-Schlüssel-Format

  • Beginnt mit sk-
  • Enthält zufällig generierte Zeichen
  • Beispiel: sk-abc123def456ghi789...

Schritt 2: Führen Sie Ihren ersten API-Aufruf durch

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

Mit 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 oder Base64-String
  } catch (error) {
    console.error('Error:', error);
    throw error;
  }
}
 
// Verwendung
const restoredImage = await restorePhoto(
  'https://example.com/old-photo.jpg',
  'your-api-key-here'
);
console.log('Restored image:', restoredImage);

Schritt 3: Behandeln Sie die Antwort

Die API gibt eine JSON-Antwort mit dem restaurierten Bild zurück:

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

Oder im Base64-Format:

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

Das output-Feld enthält:

  • Bild-URL: Direkter Link zum restaurierten Bild
  • Base64-String: Als Base64 kodierte Bilddaten

Schritt 4: Zeigen Sie das Ergebnis an

In HTML

<img src="https://replicate.delivery/pbxt/xxx.png" alt="Restauriertes Foto" />

In JavaScript

// Für URL oder Base64
const img = document.createElement('img');
img.src = restoredImage; // output-Feld aus der API-Antwort
document.body.appendChild(img);

Schritt 5: Fehlerbehandlung

Implementieren Sie immer eine ordnungsgemäße Fehlerbehandlung:

try {
  const restoredImage = await restorePhoto(imageUrl, apiKey);
  // Erfolg behandeln
} catch (error) {
  if (error.message.includes('401')) {
    console.error('Ungültiger API-Schlüssel');
  } else if (error.message.includes('402')) {
    console.error('Unzureichende Credits');
  } else if (error.message.includes('429')) {
    console.error('Rate-Limit überschritten');
  } else {
    console.error('API-Fehler:', error.message);
  }
}

API-Schlüssel-Verwaltung

Schlüssel in Einstellungen verwalten

  • Alle API-Schlüssel anzeigen
  • Schlüssel-Nutzungsstatistiken anzeigen
  • Ungenutzte Schlüssel deaktivieren oder löschen
  • Letzte Nutzungszeit für Schlüssel anzeigen

Sicherheits-Best-Practices

  • API-Schlüssel niemals im Client-seitigen Code hartcodieren
  • Schlüssel mit Umgebungsvariablen speichern
  • API-Schlüssel regelmäßig rotieren
  • Verschiedene Schlüssel für verschiedene Umgebungen verwenden

Umgebungsvariablen-Beispiel

# .env-Datei
PHOTO_RESTORE_API_KEY=sk-your-api-key-here
// Im Code verwenden
const apiKey = process.env.PHOTO_RESTORE_API_KEY;