Video-API-Lösung
Video ist in den meisten Produkten das teuerste Ergebnis und das am längsten erwartete. Beide Zahlen entstehen aus drei Feldern im Anfragekörper, und der Auftrag läuft weiter, lange nachdem die auslösende Anfrage verschwunden ist.
Die Herausforderung
Eine Videoanfrage ist keine langsamere Bildanfrage. Länge, Auflösung und der Audioschalter bestimmen Ihren Preis und Ihre Wartezeit, und zwar bevor ein einziges Bild existiert.
01
Die meisten Video-Endpunkte rechnen pro Ausgabesekunde in der gewählten Auflösung ab. duration_seconds von 5 auf 10 verdoppelt die Kosten ungefähr, eine Auflösungsstufe noch einmal. Beide sind im Schema als preisrelevant markiert, deshalb gehört die Schätzung neben das Bedienelement und nicht auf die Rechnung.
02
Wo generate_audio existiert, verschiebt dieser Schalter die Anfrage auf einen anderen Tarif. Ein Formular, das ihn versteckt, verschickt still jedes Mal die teurere Variante.
03
createTask antwortet mit 202 Accepted und einer taskId im Zustand queued. Die Erzeugung läuft serverseitig noch Minuten weiter. Wer auf dem ursprünglichen Socket wartet, läuft in einen Timeout, während Auftrag und Kosten weiterlaufen.
Der Ansatz
Holen Sie mit POST /api/v1/jobs/quote eine Schätzung für genau diesen Anfragekörper, zeigen Sie den Betrag an und senden Sie denselben Körper dann mit quoteId, expectedCost und einem gespeicherten Idempotency-Key an createTask. Ein zwischenzeitlich geänderter Preis scheitert mit Geschäftscode 40901, statt später auf der Rechnung aufzutauchen.
Ein Erstellungsaufruf transportiert Modell, geprüfte Eingabe und optional einen Callback. HTTP 202 heißt angenommen, nicht fertig.
POST /api/v1/jobs/createTask
POST /api/v1/jobs/createTask
Authorization: Bearer $SPICY_API_KEY
Idempotency-Key: 7b1f0c2e-9a4d-4f31-8c67-2b5e0d9a1c44
Content-Type: application/json
{
"model": "<publisher>/<model>/text-to-video",
"input": {
"prompt": "A slow aerial drift over a misty pine forest at sunrise",
"duration_seconds": 5,
"resolution": "1080p",
"generate_audio": true
},
"callBackUrl": "https://example.com/hooks/spicyapi"
}202 Accepted
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3
{
"code": 200,
"msg": "success",
"request_id": "req_example_create",
"data": {
"taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
"state": "queued",
"estimatedCost": "0.750000"
}
}Vertrag
| Feld oder Header | Wert oder Grenze |
|---|---|
| POST /api/v1/jobs/createTask | 202 Accepted · state queued |
| duration_seconds · resolution · generate_audio | price-affecting fields |
| Idempotency-Key | 24 h · scoped to one API key |
| output.assets[].expiresAt | signed URL · results kept 14 days |
Horizontal wischen, um alle Spalten zu sehen.
Integration
Passung
Belege
Das Formular jeder Modellseite entsteht aus dem input_schema dieses Endpunkts, und der Server prüft gegen dasselbe Dokument. Ein nicht deklariertes Feld ergibt 400 statt stillem Verwerfen.
createTask reserviert den geschätzten Betrag und gibt ihn als cost mit settled: false zurück. Die Endabrechnung übersteigt die Reservierung nie; bei Fehler oder Ablauf wird sie vollständig freigegeben.
Begrenzen Sie einen Schlüssel pro Tag, pro Monat und über seine Laufzeit, beschränken Sie ihn auf bestimmte Modelle und Quell-IPs, und senden Sie jede Schreiboperation mit demselben Idempotenzschlüssel.
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
Vergleichen Sie Video-Endpunkte nach Länge, Auflösung, Audio und Preis und senden Sie dieselbe Anfrage anschließend serverseitig.
