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

Video-Upload vorbereiten

Generierte Referenz für POST /video-uploads: Authentifizierung, Felder, Antworten, Fehler und sichere Nutzung.

Öffentliche BetaAPI v1 · 1.5.0Zuletzt geprüft
Auf dieser Seite

Operation

POST /video-uploads

operationId: create_video_upload_v1_video_uploads_post

Erstellt einen privaten Upload für MP4/MOV/WebM bis 100 MiB und 30 Sekunden. Übertrage die Bytes und schließe den Upload ab; keine Tiefenberechnung oder Generierung.

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
byte_size integer Ja — maximum: 104857600; exclusiveMinimum: 0 Exact byte count, at most 100 MiB. The source must be 2–30 seconds.
filename string Ja — minLength: 1; maxLength: 240 Client filename, not a readable server path.
mime_type string Ja — enum: "video/mp4", "video/quicktime", "video/webm" Actual MP4, MOV or WebM media type.

Vollständiges verschachteltes Schema: VideoUploadRequest

Antworten

HTTP Inhalt Bedeutung
201 VideoUploadSession Successful public response. Example values are illustrative.
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 Idempotency conflict; only IDEMPOTENCY_IN_PROGRESS is retryable with the original request.
410 APIErrorEnvelope Upload session expired; prepare a new upload.
413 APIErrorEnvelope Request or decoded image exceeds the configured limit.
415 APIErrorEnvelope Use supported image media types.
422 APIErrorEnvelope Video metadata or size is invalid.
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

json
{
  "expires_at": "2026-08-30T00:00:00Z",
  "headers": {
    "Content-Type": "video/mp4",
    "X-AnimGen-Upload-Token": "illustrative-only"
  },
  "max_bytes": 104857600,
  "method": "PUT",
  "upload_id": "00000000-0000-4000-8000-000000000001",
  "upload_url": "https://uploads.example.invalid/illustrative-video"
}

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