Zum Artikel springen
Dokumentation

Dokumentation durchsuchen

Die Suche bleibt in diesem Browser. Suchbegriffe werden weder gesendet noch gespeichert. Füge keine Zugangsdaten ein.

Öffentlicher Suchindex wird geladen…

Tab oder Pfeiltasten zum Navigieren · Enter zum Öffnen · Esc zum Schließen
Dokumentationsverzeichnis

Animationsexport mit gespeichertem Video fortsetzen

Generierte Referenz für POST /animations/{animation_id}/retry-export: Authentifizierung, Felder, Antworten, Fehler und sichere Nutzung.

Öffentliche BetaAPI v1 · 1.5.0Zuletzt geprüft
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

json
{
  "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

Brauchst du Hilfe? Support kontaktieren