Animation kalkulieren
Generierte Referenz für POST /animations/quote: Authentifizierung, Felder, Antworten, Fehler und sichere Nutzung.
Auf dieser Seite
Operation
POST /animations/quote
operationId: quote_one_click_animation_v1_animations_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 |
|---|---|---|---|---|---|
export |
ExportOptions | Nein | {"fps":null,"frame_count":24,"output_formats":["spritesheet"],"output_height":512,"output_width":512,"transparent":{"enabled":false},"unity":{"pivot":"bottom_center","pixels_per_unit":100}} |
— | Export after video generation. Alpha-bearing formats require an alpha_key source; compatible formats automatically enable its transparent export. |
input |
GenerationInput | Ja | — | — | Images owned by the caller or supplied for this generation. |
metadata |
object |
Nein | {} |
— | Caller metadata: simple string/number/boolean/null values, at most 4 KiB JSON. Do not store secrets. |
negative_prompt |
string |
Nein | "" |
maxLength: 4000 |
Optional exclusions, only when the model supports negative prompts. |
prompt |
string |
Nein | "" |
maxLength: 8000 |
Motion instruction; nonempty when the model requires a prompt. Keep private prompts out of logs. |
selection |
Selection | Nein | {"duration_seconds":null,"mode":"full","start_seconds":0} |
— | Interval selected after generation; full by default. |
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} |
— | Model-compatible generation settings. |
Vollständiges verschachteltes Schema: AnimationCreateRequest
Beispielanfrage
{
"export": {
"frame_count": 24,
"output_formats": [
"frames_zip"
],
"output_height": 512,
"output_width": 512
},
"input": {
"first_frame": {
"file_id": "00000000-0000-4000-8000-000000000001",
"type": "file"
}
},
"prompt": "A character runs in place, side view, fixed camera.",
"selection": {
"mode": "full"
}
}
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