Video-Enhancer-API

Senden Sie ein Video, das bereits auf der Plattform liegt, oder eine hochgeladene Datei, und erhalten Sie eine verbesserte Version in 1080p, 2K oder 4K. Die Schärfung von Bildtext lässt sich ein- oder ausschalten. Sie können das ganze Video oder einen Ausschnitt von bis zu 10 Minuten verarbeiten.

Unterstützte Videoquellen

Übergeben Sie eine Datei-URL der Plattform oder die identity aus der Upload-API. Lokale Uploads erfordern ein Starter-Abonnement oder höher.

Ablauf

Senden Sie eine Verbesserungsaufgabe mit Quellvideo und Zielauflösung
Fragen Sie das Ergebnis ab, bis status DONE oder ERROR ist
Lesen Sie output_url, wenn status DONE ist

Endpunkte

Methode	Pfad	Beschreibung
`POST`	`/api/v2/video-enhancer`	Verbesserungsaufgabe senden
`GET`	`/api/v2/video-enhancer/results/{id}`	Aufgabenergebnis abrufen

Alle Anfragen benötigen:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
x-wayinvideo-api-version: v2

Verbesserungsaufgabe senden

POST https://wayinvideo-api.wayin.ai/api/v2/video-enhancer

Anfragekörper

Parameter	Typ	Erforderlich	Standard	Beschreibung
`video_url`	string	Ja	—	Datei-URL der Plattform oder die `identity` aus der Upload-API.
`target_res`	string	Ja	—	Ausgabeauflösung. Erlaubte Werte: `1080p`, `2k`, `4k`.
`enable_text_hd`	boolean	Nein	`true`	Bildtext schärfen. Wird das Feld weggelassen, gilt `true`.
`start_ms`	integer	Nein	—	Ausschnittbeginn in Millisekunden. Wenn `start_ms` und `end_ms` fehlen, wird das ganze Video verarbeitet, weiterhin mit der Obergrenze von 10 Minuten. Nur eines der beiden Felder wird abgelehnt.
`end_ms`	integer	Nein	—	Ausschnittende in Millisekunden. Muss größer als `start_ms` sein und darf die Quelldauer nicht überschreiten.

Der verarbeitete Bereich darf höchstens 10 Minuten lang sein. Die Abrechnung nutzt diesen Bereich und rundet auf die nächste volle Sekunde auf. Die Sätze stehen auf der Seite Abrechnung.

Beispielanfrage

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/video-enhancer \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{
    "video_url": "EF_up_06wguq1afbwg1",
    "target_res": "1080p",
    "enable_text_hd": true,
    "start_ms": 0,
    "end_ms": 8000
  }'

import requests

requests.post(
    "https://wayinvideo-api.wayin.ai/api/v2/video-enhancer",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "x-wayinvideo-api-version": "v2",
    },
    json={
        "video_url": "EF_up_06wguq1afbwg1",
        "target_res": "1080p",
        "enable_text_hd": True,
        "start_ms": 0,
        "end_ms": 8000,
    },
)

await fetch('https://wayinvideo-api.wayin.ai/api/v2/video-enhancer', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'x-wayinvideo-api-version': 'v2',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    video_url: 'EF_up_06wguq1afbwg1',
    target_res: '1080p',
    enable_text_hd: true,
    start_ms: 0,
    end_ms: 8000,
  }),
});

Antwort

Eine neu gesendete Aufgabe ist in der Regel PENDING (in der Warteschlange) oder IN_PROGRESS (wird bereits ausgeführt).

{
  "data": {
    "id": "proj_01HQ2X8J3K4L5M6N7O8P9Q0R",
    "status": "IN_PROGRESS"
  }
}

Feld	Typ	Beschreibung
`id`	string	Project-ID. Wird im Ergebnispfad übergeben.
`status`	string	`PENDING` (Warteschlange), `IN_PROGRESS` (läuft), `DONE` (fertig) oder `ERROR` (fehlgeschlagen).
`output_url`	string	URL des verbesserten Videos. Nur vorhanden, wenn `status` `DONE` ist.

Verbesserungsergebnis abrufen

Fragen Sie mit der id aus der Sendeantwort ab, bis status DONE oder ERROR ist. Lesen Sie output_url, wenn status DONE ist.

GET https://wayinvideo-api.wayin.ai/api/v2/video-enhancer/results/{id}

Beispielanfrage

curl -X GET https://wayinvideo-api.wayin.ai/api/v2/video-enhancer/results/proj_01HQ2X8J3K4L5M6N7O8P9Q0R \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"

Antwort

{
  "data": {
    "id": "proj_01HQ2X8J3K4L5M6N7O8P9Q0R",
    "status": "DONE",
    "output_url": "https://cdn.viralhub.ai/user/video_0_8000_1080p.mp4"
  }
}

Die Felder entsprechen der Sendeantwort. output_url ist enthalten, wenn die Aufgabe abgeschlossen ist.

Abrechnung

Der Video-Enhancer verbraucht API-Einheiten für den verarbeiteten Bereich, aufgerundet auf die nächste volle Sekunde. Weniger als 1 Sekunde zählt als 1 Sekunde.

Zielauflösung	API-Einheiten
1080p	1 pro Sekunde
2K (`2k`)	2 pro Sekunde
4K (`4k`)	4 pro Sekunde

Wenn nicht genügend API-Einheiten vorhanden sind, wird die Aufgabe nicht erstellt und es werden keine Einheiten abgezogen. Siehe Abrechnung und Statuscodes.

Fehler

Fehlgeschlagene Anfragen verwenden die üblichen Statuscodes und Antwortformate. Siehe Statuscodes.