PicRenew Entwickler-API

Die PicRenew-API ermöglicht es Ihnen, Fotos programmgesteuert wiederherzustellen und zu verbessern. Sie können Wiederherstellungsaufträge einreichen, deren Status abfragen und Ergebnisse per Webhook empfangen — alles aus Ihrer eigenen Anwendung.

Basis-URL

https://picrenew.com/api/v1

Schnellstart

Erstellen Sie einen API-Schlüssel auf Ihrer Kontoseite (unter „Entwickler-API“).
Fügen Sie den Schlüssel als Bearer-Token in jede Anfrage ein.
Senden Sie eine Wiederherstellung mit POST /v1/restorations.
Fragen Sie GET /v1/restorations/:id ab, bis status abgeschlossen ist.
Laden Sie das Ergebnis von output_url.

Authentifizierung

Alle Anfragen erfordern einen Authorization: Bearer <key> -Header. API-Schlüssel haben das Präfix pk_live_. Siehe die Seite Authentifizierung für vollständige Details.

Ratenlimits

Bereich	Limit	Fenster
Pro API-Schlüssel	60 Anfragen	1 Minute (gleitendes Fenster)

Wenn das Limit überschritten wird, gibt die API 429 Too Many Requests mit einem Retry-After -Header zurück (Sekunden bis zum Reset des Fensters).

Fehlerantworten

Alle Fehler geben JSON mit einem error -Feld zurück:

{
  "error": "Insufficient credits"
}

Status	Bedeutung
`400`	Ungültige Anfrage — invalid Parameter
`401`	Fehlender oder ungültiger API-Schlüssel
`402`	Unzureichende Credits
`404`	Ressource nicht gefunden
`429`	Ratenlimit überschritten
`500`	Interner Serverfehler

MCP-Integration

PicRenew bietet auch einen MCP (Model Context Protocol) MCP-Server unter https://picrenew.com/api/mcp — derselbe Bearer-API-Schlüssel authentifiziert ihn. Siehe die Seite MCP-Endpunkt .

Credits

Credit cost is based on output resolution only. All restoration presets (standard, enhance, colorize, portrait) cost the same — there is no surcharge for options.

Operation	Cost
Restore (any preset, any options)	1 credit (1k) · 2 credits (2k) · 3 credits (4k)
Superscale	1 credit · free for subscribers

Options like colorize and remove_frame do not add to the credit cost — they change the prompt sent to the AI, not the price.

Credits werden atomisch beim Erstellen der Wiederherstellung abgebucht. Wenn der Auftrag nicht in die Warteschlange gestellt werden kann, werden Credits automatisch erstattet.

Nächste Schritte

Authentifizierung — Schlüsselformat, Sicherheit
Restaurierungen — vollständige Endpoint-Referenz
MCP-Endpunkt — PicRenew in KI-Clients verwenden