Animationsexport mit gespeichertem Video fortsetzen
Generierte Referenz für POST /animations/{animation_id}/retry-export: Authentifizierung, Felder, Antworten, Fehler und sichere Nutzung.
Auf dieser Seite
Operation
POST /animations/{animation_id}/retry-export
operationId: retry_one_click_animation_export_v1_animations__animation_id__retry_export_post
Setzt den Export einer eigenen Animation fort, wenn das Video gespeichert wurde, der Export aber am Speicherlimit scheiterte. Schaffe zuerst freien Speicher oder erhöhe das Limit und folge error.details.recovery. Das ursprüngliche Video und dieselbe Export-ID werden ohne erneute Generierung oder zusätzliche Credits verwendet. Wiederholte Aufrufe geben denselben Export zurück. Kein Anfragetext oder Idempotency-Key erforderlich. Bei HTTP 202 die ursprüngliche Animations-ID weiter abfragen. Abgebrochene, erstattete Aufträge, gelöschte Quellvideos und andere Fehler sind ausgeschlossen.
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
| Parameter | Position | Typ | Erforderlich | Einschränkungen / Standardwert | Bedeutung |
|---|---|---|---|---|---|
animation_id |
path |
string |
Ja | format: uuid |
Owned public resource UUID; task, asset, and file IDs are not interchangeable. |
Antworten
| HTTP | Inhalt | Bedeutung |
|---|---|---|
200 |
TaskResponse | Current terminal animation result; inspect status and error. |
202 |
TaskResponse | Export resumed; poll the original animation ID. No additional generation or charge. |
400 |
APIErrorEnvelope | Invalid input; correct the request before retrying. |
401 |
APIErrorEnvelope | Missing, expired, or revoked API key. |
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. |
409 |
APIErrorEnvelope | This animation cannot resume its export. |
413 |
APIErrorEnvelope | Request or decoded image exceeds the configured limit. |
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 |
|---|---|---|---|
200 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
202 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
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
{
"created_at": "2026-08-30T00:00:00Z",
"credits": {
"charged": 1,
"held": 0,
"quoted": 1
},
"error": null,
"finished_at": "2026-08-30T00:00:00Z",
"id": "00000000-0000-4000-8000-000000000002",
"metadata": {},
"normalized_input": {},
"object": "animation",
"outputs": [
{
"byte_size": 1024,
"created_at": "2026-08-30T00:00:00Z",
"download_expires_at": "2026-08-30T01:00:00Z",
"download_url": "https://downloads.example.invalid/illustrative-asset",
"format": "clip_video",
"id": "00000000-0000-4000-8000-000000000003",
"media": {
"duration_seconds": 5.04,
"fps": 25,
"frame_count": 126,
"height": 512,
"width": 512
},
"mime_type": "video/mp4",
"object": "asset"
},
{
"byte_size": 1024,
"created_at": "2026-08-30T00:00:00Z",
"download_expires_at": "2026-08-30T01:00:00Z",
"download_url": "https://downloads.example.invalid/illustrative-export",
"format": "frames_zip",
"id": "00000000-0000-4000-8000-000000000006",
"mime_type": "application/zip",
"object": "asset"
}
],
"progress": 1,
"stage": "completed",
"started_at": null,
"status": "succeeded"
}
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