Einführung
Was dieser Endpunkt macht
Er nimmt einen Videoclip und liefert denselben Clip in einer höheren Auflösungsstufe zurück. Länge, Seitenverhältnis, Bewegung, Schnitte und Tonspur bleiben wie gesendet, und es gibt keinen Prompt.
Wichtige Eingaben
video_url ist der Clip mit 3 bis 60 Sekunden, als direkter Link auf die Datei. resolution wählt die Ausgabestufe: 720p, 1080p (Voreinstellung), 2k oder 4k. Die Stufe ist ein Pixelbudget, daher kommt ein Clip mit 832×480 bei 1080p mit 1896×1094 zurück.
Was Sie zurückbekommen
Ein MP4 pro Anfrage in der Länge der Quelle, nach Abschluss der Aufgabe aus dem Plattformspeicher ausgeliefert.
| Feld | Wert |
|---|---|
| Eingabe | Video |
| Ausgabe | Video |
| Endpunkt | Upscale |
| Stufen | 720p, 1080p, 2K, 4K |
| Abrechnung | Pro Sekunde des Ausgangsclips, aufgerundet, mindestens 3 Sekunden |
| Einstellungen | Kein Prompt – nur resolution |
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
video_url | Ja | Der hochzuskalierende Clip, 3 bis 60 Sekunden lang. mindestens 1 Zeichen |
resolution | Nein | 720p, 1080p (Voreinstellung), 2k oder 4k – ein Pixelbudget mit gleichem Seitenverhältnis, daher kommt ein Clip mit 832×480 in 1080p mit 1896×1094 zurück. |
Preis
Abgerechnet wird pro Sekunde des Ausgangsclips, auf die nächste ganze Sekunde aufgerundet, mindestens 3 Sekunden; die Ausgabestufe bestimmt den Sekundensatz. Die Schätzung vor dem Absenden nimmt bei einem hochgeladenen Clip dessen Länge plus eine Sekunde, bei einer Video-URL das Maximum von 60 Sekunden; die Differenz wird bei der Abrechnung freigegeben.
| Spezifikation | Preis |
|---|---|
| $0.006 / Sekunde |
| $0.006 / Sekunde |
| $0.012 / Sekunde |
| $0.024 / Sekunde |
Anwendungsfälle
480p-Entwürfe in Lieferqualität
Günstig in 480p oder 720p generieren, die gelungene Aufnahme behalten und nur diese hochskalieren – statt jeden Versuch teuer in hoher Auflösung zu generieren.
Social- und Werbeschnitte
Bringen Sie kurze Clips auf die Auflösung, die ein Feed, eine Landingpage oder ein Werbeplatz erwartet – die Tonspur bleibt dabei erhalten.
Ältere Aufnahmen auf großen Bildschirmen
Geben Sie kleinen Archivclips oder Bildschirmaufnahmen ein saubereres, größeres Bild für Präsentationen und große Displays.
Prompt-Leitfaden und Praxistipps
Erst schneiden, dann hochskalieren
Skalieren Sie die finale Fassung hoch. Sonst müsste jeder spätere Schritt ein Vielfaches an Pixeln verarbeiten.
video_urlund resolution sendenvideo_urlist der Clip mit 3 bis 60 Sekunden; resolution wählt 720p, 1080p (Voreinstellung), 2k oder 4k. Mehr gibt es nicht einzustellen.Abfragen, dann herunterladen
Der Aufruf ist asynchron: Aufgabe anlegen, bis zum Abschluss abfragen und das MP4 aus dem Plattformspeicher holen. Ein 5-Sekunden-Clip in 4K hat rund 19 MB.
Einführung
Video Upscaler nimmt einen fertigen Clip und liefert ihn in einer höheren Auflösungsstufe zurück. Es ist ein Auflösungsdurchgang, kein Editor: Bildausschnitt, Bewegung, Schnitte, Timing und die ursprüngliche Tonspur bleiben wie gesendet. Es gibt keinen Prompt.
Anfrage
{
"video_url": "https://example.com/clip.mp4",
"resolution": "1080p"
}
Pflicht ist nur video_url. resolution ist standardmäßig 1080p; die weiteren Stufen sind 720p, 2k und 4k.
Cliplänge und Abrechnung
Der Clip muss 3 bis 60 Sekunden lang sein. Ist die Länge bei der Annahme bekannt, wird ein Clip außerhalb dieses Bereichs sofort abgelehnt; andernfalls wird sie vor Beginn der Verarbeitung geprüft, und die Aufgabe scheitert mit voller Erstattung. Abgerechnet wird pro Sekunde des Ausgangsclips, auf die nächste ganze Sekunde aufgerundet, mindestens 3 Sekunden, zum Satz der gewählten Stufe. Die Schätzung vor dem Absenden nimmt bei einem hochgeladenen Clip dessen Länge plus eine Sekunde, bei einer Video-URL das Maximum von 60 Sekunden; der ungenutzte Teil der Reservierung wird bei der Abrechnung freigegeben.
Was zurückkommt
Die Stufe ist ein Pixelbudget, und das Seitenverhältnis bleibt erhalten. Ein Clip mit 832×480 kam bei 1080p nach etwa 33 Sekunden Verarbeitung mit 1896×1094 zurück, bei 4k nach etwa 103 Sekunden mit 3792×2188; ein 5-Sekunden-MP4 in 4k hat rund 19 MB. Ein Clip mit 854×480 und AAC-Tonspur kam mit 1922×1080 und derselben Tonspur zurück. In jedem Test stimmte die Laufzeit bis aufs Bild mit der Quelle überein.
Ablauf
Der Aufruf ist asynchron. Legen Sie die Aufgabe an, fragen Sie sie bis zu einem Endzustand ab und laden Sie dann das MP4 aus dem Plattformspeicher.
Tipps
- Skalieren Sie die finale Schnittfassung hoch, nach allen Bearbeitungen.
- Wählen Sie eine Stufe oberhalb der aktuellen Auflösung des Clips.
- Verwenden Sie einen direkten Link auf die Videodatei. Eine Webseite, die das Video abspielt, liefert HTML; die Länge lässt sich dann nicht lesen, und der Aufruf scheitert mit Erstattung. Das Hochladen der Datei ist der zuverlässigste Weg.
- Beginnen Sie mit der saubersten Quelle, die Sie haben: Kompressionsblöcke und Rauschen werden mit vergrößert.
API-Schnellstart
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/video-upscaler-v1/upscale",
"input": {
"resolution": "1080p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
