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 als video_url in 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 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}'