Videogenerierung kalkulieren
Generierte Referenz für POST /video-generations/quote: Authentifizierung, Felder, Antworten, Fehler und sichere Nutzung.
Auf dieser Seite
Operation
POST /video-generations/quote
operationId: quote_video_generation_v1_video_generations_quote_post
Schätzt den Preis des geplanten Auftrags, ohne ihn zu erstellen oder Credits zu verbrauchen. Dies fixiert keinen Preis und ist keine Ausgabenfreigabe. Bei der Erstellung wird der aktuelle Preis erneut berechnet; prüfe ihn vor dem Absenden. Preisrelevante Einstellungen müssen mit der späteren Anfrage übereinstimmen.
Authentifizierung und Nebenwirkungen
Verwende einen serverseitigen Bearer-API-Schlüssel. Erforderliche Berechtigung: animations:write
Diese Operation startet keine kostenpflichtige Generierung. Andere Zustandsänderungen sind oben beschrieben.
Parameter
Keine Pfad-, Query- oder operationsspezifischen Header-Parameter.
Anfragetext (application/json)
Anfragetext erforderlich: true
| Feld | Typ | Erforderlich | Standardwert | Einschränkungen | Bedeutung |
|---|---|---|---|---|---|
has_last_frame |
boolean |
Nein | false |
— | Whether the planned request includes a last frame. |
reference_image_count |
integer |
Nein | 0 |
minimum: 0; maximum: 8 |
Number of additional references, excluding the first frame. |
video |
VideoOptions | Nein | {"duration_seconds":null,"input_canvas":null,"model":null,"ratio":null,"resolution":null,"seed":null,"style_preset":null,"transparency":{"key_color":null,"key_selection":"auto","mode":"standard"},"watermark":null} |
— | Generation options to estimate; must match the later create. |
Vollständiges verschachteltes Schema: VideoGenerationQuoteRequest
Beispielanfrage
{
"has_last_frame": false,
"reference_image_count": 0,
"video": {}
}
Antworten
| HTTP | Inhalt | Bedeutung |
|---|---|---|
200 |
QuoteResponse | Successful public response. Example values are illustrative. |
400 |
APIErrorEnvelope | Invalid input; correct the request before retrying. |
401 |
APIErrorEnvelope | Missing, expired, or revoked API key. |
402 |
APIErrorEnvelope | Insufficient credits; do not automatically purchase. |
403 |
APIErrorEnvelope | Account eligibility, account status, or key scope does not allow this operation. |
404 |
APIErrorEnvelope | Resource is unavailable, not owned, or its signature is invalid/expired. |
413 |
APIErrorEnvelope | Request or decoded image exceeds the configured limit. |
415 |
APIErrorEnvelope | Use supported image media types. |
422 |
APIErrorEnvelope | Decoded image dimensions exceed the allowed size. |
429 |
APIErrorEnvelope | Account-wide rate or queue limit; wait for Retry-After. |
500 |
APIErrorEnvelope | Internal failure; preserve the task/key and retry only when marked retryable. |
503 |
APIErrorEnvelope | Service/provider unavailable; retry only when error.retryable is true. |
Antwort-Header
| HTTP | Header | Typ | Bedeutung |
|---|---|---|---|
429 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
503 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
Beispielantwort
{
"breakdown": {},
"credits": 1,
"object": "quote"
}
Weiterführende Anleitungen
Statusabfragen und Downloads · Fehler und sichere Wiederholungen
War diese Seite hilfreich?
Es werden keine Suchbegriffe, Codes oder Freitexte erfasst. Dieser Schalter steuert nur Dokumentationsinteraktionen; allgemeine Website-Analysen folgen der Datenschutzerklärung. Datenschutzerklärung