Integration für den Produktivbetrieb
Anfragen nachvollziehbar ausführen, Kosten bestätigen und Ergebnisse zuverlässig speichern.
Modell und Protokoll auswählen
Laden Sie inputSchema und Beispiele aus dem authentifizierten Live-Katalog. enabled und available müssen beide true sein. Eine öffentliche Modellseite belegt keine aktuelle Aufrufberechtigung. Native Aufgaben verwenden /api/v1, kompatible Clients /v1. Konsolen-Cookies sind keine API-Zugangsdaten.
Eingaben auf dem Server vorbereiten
Bewahren Sie den API-Schlüssel im Backend auf, nicht im Browser, in mobilen App-Paketen oder öffentlichen Repositories. Beachten Sie Typen, Auswahlwerte und bedingte Pflichtfelder des aktuellen Schemas. Dateien durchlaufen Upload-Ticket, PUT und commit; anschließend übergeben Sie die spicy://-URI im vorgesehenen Modellfeld. Nach einem Modellwechsel erneut validieren.
Kosten vor der Annahme bestätigen
Senden Sie model, input und callBackUrl vollständig an jobs/quote. Zeigen Sie estimatedCost, maxCharge, currency und expiresAt an. Das Angebot gilt fünf Minuten und reserviert kein Guthaben. Ergänzen Sie nach der Bestätigung dieselbe Anfrage um quoteId und expectedCost. Bei geänderten Eingaben oder 40901 ist ein neues Angebot nötig. Höhere Beträge nicht stillschweigend bestätigen; Geldwerte als Dezimalzeichenfolgen speichern.
Geschäftsvorgang dauerhaft speichern
Speichern Sie vor dem Senden Vorgangs-ID, einen sicheren Anfrage-Fingerabdruck und Idempotency-Key. Ergänzen Sie danach taskId und request_id. Für dasselbe Konto, denselben API-Schlüssel und denselben Vorgang gilt innerhalb von 24 Stunden der ursprüngliche Schlüssel. Ein Timeout beweist keine Ablehnung. Ein erneuter Versuch nach endgültigem Fehlschlag erzeugt eine neue Aufgabe zu aktuellen Bedingungen.
Callbacks und Ergebnisse verarbeiten
Prüfen Sie Signatur und Zeitstempel anhand der unveränderten Bytes, entfernen Sie Duplikate und speichern Sie das Ereignis dauerhaft. Antworten Sie zügig und verlagern Sie lange Verarbeitung in Ihre Warteschlange. Verzögerte und doppelte Ereignisse anhand des Aufgabenstatus behandeln. Polling von recordInfo ist ein begrenzter Fallback mit exponentiellem Backoff. 202 bedeutet angenommen, succeeded erfolgreich erzeugt, settled=true endgültig abgerechnet.
Parallelität und Aufbewahrung begrenzen
Begrenzen Sie laufende Aufgaben je Konto und setzen Sie Zeitlimits. Beachten Sie Retry-After bei 429 und vermeiden Sie gleichzeitige sekündliche Abfragen. Kataloge nur kurz und privat cachen. Download-Links gelten 20 Minuten, erzeugte Medien bleiben 14 Tage, Uploads einen Tag. Benötigte Ergebnisse rechtzeitig archivieren. Ein Verbindungsabbruch storniert keine angenommene Aufgabe.
Vor dem Start prüfen
Prüfen Sie zuerst Katalog, Guthaben und Angebote, danach eine minimale Generierung mit Ihrer Kostenfreigabe. Testen Sie Erfolg, ungültige Eingaben, Guthabenmangel, Wiederaufnahme mit demselben Schlüssel, doppelte Callbacks, abgelaufene Links und Budgets. Protokollieren Sie request_id, taskId, Zeit, Status und Betrag; keine Schlüssel oder vollständigen Prompts.
Weitere Abläufe
Kostenschätzungen und Protokollkompatibilität · Modelle und Endpunkte · Medien hoch- und herunterladen · Webhooks · Fehler und Wiederholungen · Fehlerdiagnose und Wiederherstellung