Animation exportieren
Generierte Referenz für export_animation: Argumente, Ergebnisschema, OAuth-Berechtigungen und Sicherheitsannotation aus dem geprüften MCP-Vertrag.
Auf dieser Seite
Tool
export_animation
Startet einen kostenpflichtigen Export aus einem vorhandenen Video mit freigegebener quote_id oder max_credits. Änderungen an Bereich oder FPS erstellen einen neuen Export, generieren die Quellbewegung aber nicht erneut.
Berechtigungen und Sicherheit
OAuth-Berechtigung: animations:write
| Signal | Wert |
|---|---|
destructiveHint |
true |
idempotentHint |
true |
openWorldHint |
false |
readOnlyHint |
false |
| spendsCredits | true |
| requiresUserConfirmation | true |
| sideEffects | export_started, credits_reserved_or_charged |
Annotationen beschreiben Sicherheitseigenschaften. Sie ersetzen weder Zustimmung noch OAuth-Autorisierung oder serverseitige Prüfungen.
Eingabeargumente
| Feld | Typ | Erforderlich | Standardwert | Einschränkungen | Bedeutung |
|---|---|---|---|---|---|
idempotency_key |
string |
Ja | — | minLength: 8; maxLength: 200 |
Reuse unchanged on retry; use a new key when changing the selection or FPS. |
max_credits |
integer / null |
Nein | null |
minimum: 0 |
Approved per-operation credit cap. |
quote_id |
string / null |
Nein | null |
format: uuid |
— |
request |
AnimationExportCreateRequest | Ja | — | — | — |
Beispielargumente
{
"idempotency_key": "example-export-001",
"max_credits": 0,
"request": {
"export": {
"fps": 12,
"output_formats": [
"spritesheet",
"spritesheet_json"
]
},
"selection": {
"duration_seconds": 2,
"mode": "range",
"start_seconds": 1
},
"source_video_asset_id": "00000000-0000-4000-8000-000000000003"
}
}
Strukturiertes Ergebnis
| Feld | Typ | Erforderlich | Standardwert | Einschränkungen | Bedeutung |
|---|---|---|---|---|---|
created_at |
string |
Ja | — | format: date-time |
UTC acceptance timestamp. |
credits |
CreditUsage | Ja | — | — | Quoted, reserved, and charged credit states. |
error |
TaskError / null |
Nein | null |
— | Task failure details, independently of any usable outputs. |
finished_at |
string / null |
Nein | null |
format: date-time |
UTC terminal timestamp when known. |
id |
string |
Ja | — | format: uuid |
Persist this task ID immediately after create; poll it instead of creating again. |
metadata |
object |
Nein | {} |
— | Caller-provided metadata. |
normalized_input |
object |
Nein | {} |
— | Normalized public input; may contain private prompts or image references. Do not log wholesale. |
object |
string |
Ja | — | enum: "video_generation", "animation_export", "animation" |
Public task resource type. |
outputs |
array<AssetResponse> | Nein | [] |
— | Available assets, including partial outputs on failed/cancelled tasks. Always inspect them at a terminal state. |
progress |
number |
Ja | — | minimum: 0; maximum: 1 |
Fraction from 0 to 1, not a completion-time estimate. |
resolved_export |
ResolvedExport / null |
Nein | null |
— | Persisted FPS sampling summary shared with the quote and manifest; null for legacy tasks. |
stage |
string / null |
Nein | null |
enum: "queued", "video_generation", "animation_export", "completed" |
Current pipeline stage when available. |
started_at |
string / null |
Nein | null |
format: date-time |
UTC production start when known. |
status |
string |
Ja | — | enum: "queued", "running", "cancelling", "succeeded", "failed", "cancelled" |
succeeded, failed, and cancelled are terminal; cancelling is not terminal. |
Fehler und nächste Schritte
Tool-Fehler enthalten ein error-Objekt mit code, message, retryable, request_id und details. Steuere den Ablauf nicht anhand des Meldungstexts und lege keine privaten Eingaben offen. Prüfe nach endgültigen Fehlern auch Teilergebnisse; eine signierte URL ist noch keine gespeicherte Datei.
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