Upload-API
Die Upload-API ermöglicht es Ihnen, lokale Video- oder Audiodateien zu WayinVideo hochzuladen. Nach dem Hochladen verwenden Sie die zurückgegebene Dateikennung als video_url in anderen API-Endpunkten (KI-Clipping, Momente finden, Videozusammenfassung, Videotranskription).
Abonnement erforderlich: Das Hochladen lokaler Dateien erfordert einen Standard-Plan oder höher. Weitere Details finden Sie auf der Seite Abonnementpläne.
Dateigrößenlimit: Das Limit für einzelne Dateien beträgt 5 GB. Wenn Sie ein höheres Limit benötigen, kontaktieren Sie uns unter wayinvideo@wayin.ai.
Unterstützte Formate: avi, mp4, mov, webm. Das Hochladen anderer Formate kann zu Verarbeitungsfehlern führen.
Upload-Ablauf
- Anfragen: Upload-URL mit Datei-Metadaten anfordern
- Hochladen: Datei direkt an die vorab signierte URL per
PUT-Anfrage senden - Verwenden: Zurückgegebenen
identity-Wert alsvideo_urlin nachfolgenden API-Aufrufen verwenden
Upload-URL abrufen
POST https://wayinvideo-api.wayin.ai/api/v2/upload/single-file
Anfragekörper
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
name | string | Ja | Dateiname 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"}}
| Feld | Typ | Beschreibung |
|---|---|---|
upload_url | string | Vorab signierte URL für den Upload. Läuft nach 1 Stunde ab. |
identity | string | Dateikennung 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
identityist 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. Reine Audiodateien sollten vor dem Upload in eines dieser Containerformate gemuxt werden. 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 beliebigen Verarbeitungs-Endpunkt — AI Clipping, Find Moments, Video Summarization oder Video Transcription.