Checkliste für den Livegang

Eine Demo braucht eine Anfrage. Ein Produkt muss Timeouts, doppelte Webhooks, abgelaufene Links und einen geleakten Schlüssel überstehen. Geh diese Liste vor dem Start durch.

Schlüssel

• Der Schlüssel liegt im Secret-Speicher deines Servers, nie in einem Browser- oder App-Bundle.
• Jede Umgebung und jeder Dienst hat einen eigenen Schlüssel, damit sich einer allein widerrufen lässt.
• Produktionsschlüssel sind auf die genutzten Modelle beschränkt und haben ein Tageslimit.
• Du weißt, wie du einen Schlüssel ohne Ausfall rotierst (Authentifizierung).

Tasks erstellen

• Jedes createTask sendet einen Idempotency-Key, abgeleitet aus deiner eigenen Job-ID, einmal erzeugt und bei jeder Wiederholung wiederverwendet.
• Nur 429, 500, 503 und 50301 werden wiederholt, mit Backoff und Retry-After (Fehler).
• 400, 40004 und andere „Anfrage korrigieren“-Fehler werden angezeigt oder geloggt, nicht wiederholt.
• Wenn du Preise zeigst, fragst du zuerst ein Angebot ab, übergibst quoteId und expectedCredits und behandelst 40901.
• Ein niedriges Guthaben (40201) erreicht einen Menschen – Alarm, E-Mail, Banner –, bevor Nutzer es merken.

Ergebnisse empfangen

• Tasks haben eine callBackUrl; dein Endpunkt prüft die Signatur und lehnt veraltete Zeitstempel ab.
• Der Webhook-Handler antwortet schnell mit 2xx und erledigt die Arbeit im Hintergrund.
• Doppelte Zustellungen werden anhand von request_id ignoriert.
• Ein regelmäßiger Durchlauf liest Tasks, deren Webhook nie ankam.
• Dein Code behandelt jeden Zustand außer succeeded, failed, expired und canceled als „läuft noch“.

Dateien

• Fertige Dateien werden in deinen eigenen Speicher (oder deine Asset-Bibliothek) kopiert, statt auf die signierte URL zu verlinken, die nach etwa 20 Minuten abläuft.
• Du speicherst taskIds, keine signierten Links.
• Dein Download-Code schickt den API-Schlüssel nicht an die signierte URL.
• Referenzdateien sind öffentliche HTTPS-Links auf die Datei selbst, Uploads oder Assets – keine Freigabeseiten.

Kosten

• Du kennst die Preiseinheit jedes Modells (pro Bild, pro Sekunde, pro Anfrage) und die Einstellungen, die sie erhöhen.
• Vorschauen und Tests laufen mit der günstigsten Auflösung und kürzesten Dauer.
• Ein Ausgabelimit stoppt außer Kontrolle geratene Schleifen, bevor sie das Guthaben leeren.
• Du prüfst credits und settled, statt anzunehmen, dass die Schätzung abgebucht wurde.

Monitoring

• Du loggst request_id, taskId, code und errorCode bei jedem Fehler.
• Du beobachtest den Anteil failed pro Modell; ein plötzlicher Anstieg bedeutet meist eine Änderung an Prompt, Eingabe oder Modell.
• Du misst pro Modell die Zeit von createTask bis zum Webhook und alarmierst bei Ausreißern.
• Jemand im Team weiß, wo die Logs und die Nutzungsseite der API-Konsole sind.

Inhalte

PopNow ist ein Dienst für ein allgemeines Publikum. Modelle haben ihre eigenen Inhaltsregeln, und abgelehnte Anfragen scheitern mit content_rejected. Wenn deine Nutzer Prompts schreiben, erklär ihnen in deiner eigenen Oberfläche, warum eine Anfrage abgelehnt wurde, statt einen rohen Fehler zu zeigen, und lass sie ihn ändern.