Referenz

POST /v1/videos

Ein Clip mit Ton aus einem Text-Prompt, im Format von OpenAI: Die videos-Methoden des SDKs funktionieren, wenn nur die Base URL geändert wird. Den Clip in die Warteschlange stellen, prüfen, einmal herunterladen, danach wird er gelöscht.

Geprüft am 6. November 2026

Einen Clip erzeugen

import os
import time
from openai import OpenAI

client = OpenAI(
    base_url="https://nokeep.ai/v1",
    api_key=os.environ["NOKEEP_API_KEY"],
)

clip = client.videos.create(
    model="minimax-h3-max-turbo",
    prompt="Waves breaking on a rocky coast at dusk",
    seconds="5",
    size="1280x720",
)

while clip.status in ("queued", "in_progress"):
    time.sleep(5)
    clip = client.videos.retrieve(clip.id)

if clip.status == "completed":
    client.videos.download_content(clip.id).write_to_file("clip.mp4")

Modelle

Modell	Geeignet für	480p pro Sekunde	768p pro Sekunde	1080p pro Sekunde
minimax-h3-max-turbo	Schnell, mit Ton. Der beste Einstieg.	0,045 $	0,07 $	0,14 $
minimax-h3-max	Mehr Schritte als Turbo für feinere Details, mit Ton.	0,09 $	0,14 $	0,28 $

Bezahlt wird für die Sekunden, die Sie anfordern. Beide Modelle machen Clips von 5 bis 15 Sekunden mit Ton.

Anfrage

Feld	Nimmt	Was es bewirkt
`model`	Pflicht	Eine der oben genannten Modell-IDs.
`prompt`	Pflicht, bis 10.000 Zeichen	Was gefilmt werden soll, wird unverändert an das Modell gesendet. Über dem Limit wird abgelehnt, nie gekürzt.
`seconds`	5 bis 15	Die Länge des Clips, als Zahl oder Text. Standard ist 5. OpenAIs 4 wird abgelehnt; 8 und 12 funktionieren.
`size`	`WIDTHxHEIGHT`	Wählt die nächstgelegene Auflösung und das nächstgelegene Format. 1280x720 wird zu 768p im Format 16:9, und dafür zahlen Sie.
`resolution`	`480p`, `768p` oder `1080p`	Legt den Preis fest und gewinnt gegenüber `size`. Standard ist 768p.
`aspect_ratio`	16:9, 21:9, 4:3, 1:1, 3:4, 9:16	Gewinnt gegenüber `size`. Standard ist 16:9.

Senden Sie JSON oder das Multipart-Formular, das die SDKs von OpenAI nutzen. Jedes andere Feld, etwa seed, wird verworfen und in x-nokeep-ignored genannt. Ein Feld, das ein Bild oder einen Clip trägt, etwa input_reference, wird mit 400 unsupported_input abgelehnt: Diese Modelle arbeiten nur mit Text. Das Python-SDK von OpenAI zeigt bei seinen videos-Methoden eine Veraltungswarnung zum eigenen Videodienst von OpenAI. Das betrifft Aufrufe an uns nicht, und ein Typprüfer kann die Modell-ID anmerken.

Die Routen des Clips

Route	Was sie bewirkt
`POST /v1/videos`	Stellt einen Clip in die Warteschlange und hält seinen Preis.
`GET /v1/videos/{id}`	Zeigt, wo der Clip steht. Alle paar Sekunden prüfen.
`GET /v1/videos/{id}/content`	Die MP4-Datei. Sie funktioniert einmal, danach wird der Clip beim Host des Modells gelöscht. Bricht der Download ab, fragen Sie erneut an.
`DELETE /v1/videos/{id}`	Löscht einen fertigen Clip, ohne ihn herunterzuladen. Ein Clip, der noch rendert, antwortet mit `409 video_not_ready`.
`GET /v1/videos`	Die letzten Clips des Kontos.

Das Clip-Objekt

JSON

{
  "id": "video_8f3a…",
  "object": "video",
  "model": "minimax-h3-max-turbo",
  "status": "completed",
  "progress": 100,
  "created_at": 1793960000,
  "completed_at": 1793960030,
  "expires_at": 1794042800,
  "seconds": "5",
  "size": "1366x768",
  "resolution": "768p",
  "aspect_ratio": "16:9",
  "error": null,
  "downloaded": false,
  "expired": false,
  "usage": {
    "nokeep_credits": 350
  }
}

status ist queued, in_progress, completed oder failed.
progress ist 0, bis der Clip fertig ist, danach 100. Dazwischen meldet das Modell nichts.
size wird aus Auflösung und Format berechnet, deshalb kann die Datei um einige Pixel abweichen.

Was Sie bezahlen

Der volle Preis des Clips wird beim Einstellen in die Warteschlange reserviert, von Ihren gekauften Credits und dem Tageslimit des Schlüssels.
Berechnet wird, wenn der Clip fertig ist, ob Sie ihn herunterladen oder nicht.
Ein fehlgeschlagener Clip kostet nichts, und sein Status zeigt das an.

Wo der Clip bleibt

Ein fertiger Clip wartet beim Host des Modells, auf dessen privater Stufe, bis zu 23 Stunden. Er wird dort nach seinem einen Download gelöscht oder wenn Sie ihn löschen. Wir halten die Datei nie, und danach antwortet er mit 410 video_gone. Unsere eigene Zeile zu einem Clip enthält seine ID, den Schlüssel, das Modell, die Länge, Auflösung, das Format, Credits und Zeiten, aber nie den Prompt. Sie wird nach 48 Stunden gelöscht.

Inhalt, Limits und Fehler

Vier harte Grenzen bleiben: sexuelle Inhalte mit Minderjährigen, sexuelle Inhalte über reale Personen, Schaden mit Massenopfern und das Angreifen einer realen Person. Ein Prompt, der eine davon überschreitet, bekommt 422 hard_limit und kostet nichts. Der Host eines Modells kann eine Anfrage auch ablehnen: Das ist 422 content_refused, ebenfalls kostenlos. Siehe Harte Grenzen.

Ein Schlüssel kann 20 Clips pro Minute in die Warteschlange stellen, innerhalb seiner 120 Anfragen insgesamt, und 10 gleichzeitig rendern lassen. Darüber kommt 429 rate_limited. Die Fehlerseite listet jeden Code.

Um Ihren Code ohne Kosten zu prüfen, senden Sie sk-nokeep-test als Schlüssel. Er führt jede Prüfung aus, meldet den Clip sofort als fertig als video_test, und seine Datei ist leer.

API-Schlüssel holen Kostenlosen Testschlüssel ausprobieren: sk-nokeep-test

Was beschäftigt Sie?