Wiederherstellungen

/v1/restorations Die Ressource /v1/restorations ermöglicht es Ihnen, Wiederherstellungsaufträge zu erstellen und zu verwalten. Aufträge werden asynchron verarbeitet — reichen Sie einen Auftrag ein und fragen Sie seinen Status ab oder empfangen Sie einen Webhook bei Abschluss.

Wiederherstellung erstellen

POST/api/v1/restorations

Anfrage-Body

Feld	Typ	Erforderlich	Beschreibung
`image_url`	string	Ja	Öffentliche HTTPS-URL des wiederherzustellenden Fotos (max. 20 MB)
`preset`	string	Nein	Wiederherstellungs-Preset: `standard \| enhance \| colorize \| portrait`. Standard: `standard`.
`resolution`	string	Nein	Ausgabeauflösung: `1k \| 2k \| 4k`. Standard: `1k`.
`remove_frame`	boolean	Nein	Rahmen/Rand vor der Wiederherstellung entfernen. Standard: `false`.
`colorize`	boolean	Nein	KI-Kolorierung anwenden. Standard: `false`.
`callback_url`	string	Nein	HTTPS-Webhook-URL, die bei Auftragsabschluss aufgerufen wird. Muss öffentlich erreichbar sein.
`idempotency_key`	string	Nein	Vom Client bereitgestellter Schlüssel (max. 255 Zeichen). Das erneute Senden desselben Schlüssels gibt die vorhandene Wiederherstellung zurück, anstatt ein Duplikat zu erstellen.

Beispielanfrage

curl -X POST https://picrenew.com/api/v1/restorations \
  -H "Authorization: Bearer pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/grandma-1952.jpg",
    "preset": "enhance",
    "resolution": "2k",
    "callback_url": "https://yourapp.com/webhooks/picrenew"
  }'

Antwort — 202 Accepted

{
  "id": "a1b2c3d4-...",
  "status": "analyzing",
  "preset": "enhance",
  "resolution": "2k",
  "credits_charged": 2,
  "created_at": "2026-03-27T12:00:00.000Z",
  "expires_at": null
}

Wiederherstellungen auflisten

GET/api/v1/restorations

Gibt Ihre 50 neuesten Wiederherstellungen zurück, neueste zuerst.

Beispiel

curl https://picrenew.com/api/v1/restorations \
  -H "Authorization: Bearer pk_live_YOUR_KEY"

Antwort — 200 OK

{
  "restorations": [
    {
      "id": "a1b2c3d4-...",
      "status": "complete",
      "preset": "enhance",
      "resolution": "2k",
      "credits_charged": 2,
      "output_url": "https://...",
      "created_at": "2026-03-27T12:00:00.000Z",
      "expires_at": "2026-06-25T12:00:00.000Z"
    }
  ]
}

Wiederherstellung abrufen

GET/api/v1/restorations/:id

Gibt den aktuellen Status eines Wiederherstellungsauftrags zurück.

Statuswerte

Status	Beschreibung
`analyzing`	Auftrag erstellt, in der Warteschlange
`processing`	KI-Modell wird ausgeführt
`complete`	Abgeschlossen — `output_url` ist verfügbar
`failed`	Verarbeitung fehlgeschlagen — Credits erstattet
`expired`	Ergebnis gemäß Aufbewahrungsrichtlinie gelöscht

Wiederherstellung löschen

DELETE/api/v1/restorations/:id

Löscht den Wiederherstellungsdatensatz und den zugehörigen Blob-Speicher. Nur Wiederherstellungen mit Status complete oder failed können gelöscht werden. Credits werden für Löschungen nicht erstattet.

Antwort — 200 OK

{ "deleted": true }

Webhooks

Wenn Sie beim Erstellen einer Wiederherstellung eine callback_url angeben, sendet PicRenew einen JSON-Payload an diese URL, wenn der Auftrag einen Terminal-Status erreicht ( complete oder failed). Die Anfrage hat ein Timeout von 10 Sekunden.

Payload

{
  "id": "a1b2c3d4-...",
  "status": "complete",
  "output_url": "https://...",
  "credits_charged": 2,
  "preset": "enhance",
  "resolution": "2k",
  "created_at": "2026-03-27T12:00:00.000Z",
  "expires_at": "2026-06-25T12:00:00.000Z"
}

Ihr Endpoint sollte einen 2xx -Status zurückgeben. PicRenew wiederholt bis zu 3 Mal mit exponentiellem Backoff bei Netzwerkfehlern oder Nicht-2xx-Antworten.

Ablauf der Ergebnisse

Wiederherstellungsergebnisse werden für kostenlose Konten 90 Tage gespeichert. Abonnenten-Konten haben dauerhaften Speicher. Abgelaufene Wiederherstellungen zeigen den Status expired und haben output_url als null.