Zeitpunkte des Quellvideos ansehen
Generierte Referenz für POST /assets/{asset_id}/preview: Authentifizierung, Felder, Antworten, Fehler und sichere Nutzung.
Auf dieser Seite
Operation
POST /assets/{asset_id}/preview
operationId: preview_video_asset_v1_assets__asset_id__preview_post
Erstellt oder verwendet einen zeitlich beschrifteten Kontaktbogen des Quellvideos ohne KI oder Credit-Verbrauch. Das zwischengespeicherte Bild unterliegt Speicherquoten und regulärer Aufbewahrung. Jede Zelle zeigt angeforderten Zeitpunkt und tatsächliche Quellframe-Zeit. Signierte URLs laufen unabhängig davon ab und können über die Asset-Abfrage erneuert werden. Die undurchsichtige Quellvorschau ist kein Nachweis der endgültigen Alpha-Qualität. Maximal 12 Zeitpunkte und 512 px pro Seite; Medienbudgets stehen unter x-animgen-media-limits.
Authentifizierung und Nebenwirkungen
Verwende einen serverseitigen Bearer-API-Schlüssel. Erforderliche Berechtigung: animations:read
Diese Operation startet keine kostenpflichtige Generierung. Andere Zustandsänderungen sind oben beschrieben.
Parameter
| Parameter | Position | Typ | Erforderlich | Einschränkungen / Standardwert | Bedeutung |
|---|---|---|---|---|---|
asset_id |
path |
string |
Ja | format: uuid |
Owned public resource UUID; task, asset, and file IDs are not interchangeable. |
Anfragetext (application/json)
Anfragetext erforderlich: true
| Feld | Typ | Erforderlich | Standardwert | Einschränkungen | Bedeutung |
|---|---|---|---|---|---|
max_frame_size |
integer |
Nein | 256 |
minimum: 32; maximum: 512 |
Maximum thumbnail side in pixels, preserving aspect ratio. |
timestamps_seconds |
array<number> |
Ja | — | minItems: 1; maxItems: 12; Elemente: minimum: 0 |
Source timeline timestamps in request order, each strictly before the playable end. At most 12. |
Vollständiges verschachteltes Schema: VideoPreviewRequest
Beispielanfrage
{
"max_frame_size": 256,
"timestamps_seconds": [
0,
1,
2
]
}
Antworten
| HTTP | Inhalt | Bedeutung |
|---|---|---|
200 |
VideoPreviewResponse | 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
{
"cells": [
{
"index": 0,
"rect": {
"height": 256,
"width": 256,
"x": 0,
"y": 0
},
"requested_time_seconds": 0,
"source_time_seconds": 0
},
{
"index": 1,
"rect": {
"height": 256,
"width": 256,
"x": 256,
"y": 0
},
"requested_time_seconds": 1,
"source_time_seconds": 1
},
{
"index": 2,
"rect": {
"height": 256,
"width": 256,
"x": 512,
"y": 0
},
"requested_time_seconds": 2,
"source_time_seconds": 2
}
],
"height": 280,
"image": {
"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": "video_preview",
"id": "00000000-0000-4000-8000-000000000006",
"media": null,
"mime_type": "image/png",
"object": "asset"
},
"object": "video_preview",
"source_video_asset_id": "00000000-0000-4000-8000-000000000003",
"width": 768
}
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