Migrationsleitfaden
Zwei Plattformen können dieselbe Aufgabe anbieten und sich trotzdem bei Feldnamen, Vorgabewerten, Endzuständen, Fehlerbedeutungen und Abrechnungseinheiten unterscheiden. Eine Migration, die mit der Basis-URL beginnt, findet all das in der Produktion.
Die Herausforderung
Sauber portiert nur das Modell. Nicht portiert wird alles drumherum: welche Felder verpflichtend sind, welche Vorgaben gelten, wie ein Referenzbild hineinkommt, wann Geld reserviert wird und was Ihr Code mit einem unbekannten Zustand tun soll.
01
Schreiben Sie die Abbildung je Endpunkt auf, statt sie abzuleiten. Die Eingabe wird gegen das veröffentlichte Schema mit geschlossenem additionalProperties geprüft; ein nicht abgebildetes Feld ist ein 400 bei der ersten echten Anfrage, keine Warnung im Log.
02
createTask reserviert den Schätzwert und gibt ihn als cost mit settled: false zurück. Wenn Ihr heutiger Anbieter nur bei Erfolg abrechnet, muss Ihr Abgleich Reservierungen verstehen, bevor Verkehr umzieht.
03
Neun Werte decken jeden Fehlschlag ab, content_rejected inklusive: eine Ablehnung ist ein Endzustand, keine Ausnahme. Bilden Sie Ihre bestehenden Fehlerzweige vor der Umschaltung auf diese neun ab.
Der Ansatz
Nehmen Sie einen einzigen Ablauf, erfassen Sie heutige Eingaben, Ausgaben, Fehler und Stückkosten und fahren Sie dieselben Bedingungen hier. Vergleichen Sie die Schätzung aus jobs/quote mit dem heutigen Preis, halten Sie beide Wege hinter einem Schalter aktiv und erhöhen Sie den Anteil nur, solange die Zahlen halten.
Erst schätzen: derselbe Prüf- und Annahmeweg wie beim Erstellen, ohne Reservierung und ohne Erzeugung.
POST /api/v1/jobs/quote
{
"model": "<publisher>/<model>/text-to-video",
"input": {
"prompt": "A slow aerial drift over a misty pine forest at sunrise",
"duration_seconds": 5,
"resolution": "1080p"
}
}200 OK — nothing reserved, nothing started
{
"code": 200,
"msg": "success",
"request_id": "req_example_quote",
"data": {
"quoteId": "qte_01k3m8x9q2z4v7n5p6r8s0t1w3",
"model": "<publisher>/<model>/text-to-video",
"estimatedCost": "0.750000",
"maxCharge": "0.750000",
"currency": "USD",
"quantity": "5",
"unit": "second",
"expiresAt": "2026-09-12T12:05:00Z"
}
}Vertrag
| Feld oder Header | Wert oder Grenze |
|---|---|
| POST /api/v1/jobs/quote | no hold · signed quote valid 5 min |
| quoteId + expectedCost | 40901 when the price moved |
| 402 | 40201 balance · 40202 spend cap |
| published call name | immutable · renames keep a 308 |
Horizontal wischen, um alle Spalten zu sehen.
Integration
Passung
Belege
POST /api/v1/jobs/quote führt dieselbe Prüfung und Annahmeentscheidung aus wie das Erstellen, liefert estimatedCost, maxCharge, quantity und unit und reserviert nichts. Die signierte Schätzung gilt fünf Minuten.
Senden Sie quoteId und expectedCost beim Erstellen mit. Hat sich der Preis zwischenzeitlich geändert, liefert die Annahme Geschäftscode 40901, bevor etwas reserviert wird.
Ein veröffentlichter Aufrufname bleibt gültig; eine Umbenennung behält eine 308-Weiterleitung und einen Alias. Ihre Abbildungstabelle verfällt nicht still zwischen zwei Releases.
Vor dem Start
Häufige Fragen
Modelle
Jeder Link führt auf die Seite der jeweiligen Modellfamilie: Eingaben, Grenzen, Inhaltsrichtlinie und der aktuelle Preis je Einheit.
Weiter
Einen Ablauf nach dem anderen umziehen: Felder abbilden, Zustände und Fehler vereinheitlichen, Rechnungen vergleichen und mit erprobtem Rückweg umschalten.
Quelle: fal model APIs ↗