Upload-API

September 22, 2026

Upload-API

Die Upload-API ermöglicht es Ihnen, lokale Videodateien zu WayinVideo hochzuladen. Nach dem Hochladen verwenden Sie die zurückgegebene Dateikennung als video_url in anderen API-Endpunkten (KI-Clipping, Momente finden, Videozusammenfassung, Video Notes, Videotranskription).

Abonnement erforderlich: Das Hochladen lokaler Dateien erfordert ein Starter-Abonnement oder höher. Für die verschiedenen Abonnementpläne gelten unterschiedliche Grenzen für die Größe einzelner Dateien und den Gesamtspeicher. Weitere Details finden Sie auf der Seite Abonnementpläne.

Dateigrößenlimit: Das Limit für einzelne lokale Uploads beträgt 5 GB. Wenn Sie ein höheres Limit benötigen, kontaktieren Sie uns unter wayinvideo@wayin.ai.

Unterstützte Formate: Sie müssen eine gültige Videodatei hochladen. Derzeit unterstützte Formate: avi, mp4, mov, webm. Das Hochladen anderer Formate kann nach dem Einreichen zu Verarbeitungsfehlern führen.

Upload-Ablauf

  1. Anfragen: Upload-URL mit Datei-Metadaten anfordern
  2. Hochladen: Datei direkt an die vorab signierte URL per PUT-Anfrage senden
  3. Verwenden: Zurückgegebenen identity-Wert als video_url in nachfolgenden API-Aufrufen verwenden

Upload-URL abrufen

POST https://wayinvideo-api.wayin.ai/api/v2/upload/single-file

Anfragekörper

ParameterTypErforderlichBeschreibung
namestringJaDateiname mit Erweiterung (z.B. "my-video.mp4")
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/upload/single-file \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{"name": "sample-video.mp4"}'

Antwort

{
  "data": {
    "upload_url": "https://storage.example.com/upload/presigned-url...",
    "identity": "file_abc123"
  }
}
FeldTypBeschreibung
upload_urlstringVorab signierte URL für den Upload. Läuft nach 1 Stunde ab.
identitystringDateikennung zur Verwendung als video_url in anderen APIs

Datei hochladen

curl -X PUT "https://storage.example.com/upload/presigned-url..." \
  -H "Content-Type: video/mp4" \
  --data-binary @/Users/me/Videos/sample-video.mp4

Hochgeladene Datei verwenden

Jede identity ist 24 Stunden gültig.

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{"video_url": "THE_IDENTITY_VALUE", "enable_export": false}'

FAQ

Wann sollte ich eine lokale Datei hochladen vs. eine Quell-URL übergeben?

Wenn Ihr Video bereits auf einer unterstützten Plattform (YouTube, Vimeo, TikTok, Zoom usw.) existiert, übergeben Sie die URL direkt an den Verarbeitungs-Endpunkt — kein Upload erforderlich. Verwenden Sie die Upload-API nur für Dateien, die noch nicht auf einer unterstützten Quelle gehostet werden.

Wie groß darf eine hochgeladene Datei maximal sein?

5 GB pro Datei. Kontaktieren Sie wayinvideo@wayin.ai, falls Ihr Anwendungsfall ein höheres Limit benötigt.

Welche Dateiformate werden unterstützt?

mp4, mov, webm, avi. Andere Formate können bei der Verarbeitung fehlschlagen.

Wird der Upload auf mein Plan-Speicherkontingent angerechnet?

Ja — hochgeladene Dateien verbrauchen Speicher in Ihrem Abonnementplan. Siehe Abonnementpläne für Speicher- und Dateigrößenbeschränkungen pro Plan.

Wie verwende ich die hochgeladene Datei in anderen API-Aufrufen?

Übergeben Sie nach dem Upload die zurückgegebene Dateikennung als video_url-Feld an einen unterstützten Verarbeitungs-Endpunkt — AI Clipping, Find Moments, Video Summarization, Video Notes oder Video Transcription.