Videoerzeugung

Ein Video aus Text erstellen: die Anfrage, die Status, der Download und der Preis pro Sekunde.

Verfügbare Videomodelle

720p, no sound

0,672 $ / Sekunde

1080p, no sound

0,896 $ / Sekunde

720p, with sound

1,008 $ / Sekunde

1080p, with sound

1,344 $ / Sekunde

720p, sound included

0,896 $ / Sekunde

1080p, sound included

1,12 $ / Sekunde

So funktioniert der Ablauf

1. Senden Sie POST /v1/videos/generations mit dem Modell, einem Prompt und den Optionen. Die Antwort enthält eine request_id.
2. Videos entstehen asynchron, meist in 1–3 Minuten. Prüfen Sie den Status alle 10 Sekunden, bis er done oder failed ist.
3. Ist der Status done, laden Sie die Datei vom Pfad in video.url mit demselben Schlüssel herunter.

Anfrage

curl -sS https://api.oneprovider.dev/v1/videos/generations \
-H "Authorization: Bearer $ONEPROVIDER_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-3.0",
"prompt": "A red balloon rises over a quiet harbor at sunrise",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}'
# {"request_id":"task_..."}

Eine Kombination, die nicht in der Preistabelle steht, wird sofort mit einem 400-Fehler abgelehnt, und es wird nichts abgebucht.

Status

curl -sS https://api.oneprovider.dev/v1/videos/generations/$REQUEST_ID \
-H "Authorization: Bearer $ONEPROVIDER_KEY"
# {"request_id":"task_...","status":"pending","progress":50}
# {"request_id":"task_...","status":"done","progress":100,
# "video":{"url":"/v1/videos/generations/$REQUEST_ID/content","duration":5}}

Download

curl -sS https://api.oneprovider.dev/v1/videos/generations/$REQUEST_ID/content \
-H "Authorization: Bearer $ONEPROVIDER_KEY" \
-o video.mp4

Die Antwort ist eine Datei video/mp4, der Header Range wird unterstützt. Speichern Sie die Datei sofort bei sich; verlassen Sie sich nicht darauf, dass der Link ewig funktioniert.

Preise

Sie zahlen pro Videosekunde zum Satz der passenden Zeile in der Tabelle oben (Auflösung und Ton). Die Abbuchung erfolgt einmal, wenn der Status auf done wechselt; fehlgeschlagene oder unfertige Videos werden nicht berechnet.

Beispiel: kling-3.0, 720p, ohne Ton, 5 Sekunden = 0,672 $ × 5 = 3,36 $.

Fehler

Kurze Antworten

Welche base URL verwende ich?

Claude Code und die Anthropic-SDKs verwenden https://api.oneprovider.dev. OpenAI-SDKs und OpenAI-kompatible Clients verwenden https://api.oneprovider.dev/v1. Ein Schlüssel funktioniert an beiden Adressen; die Modellliste finden Sie auf der Modellseite , die Preise auf der Preisseite .

Wie authentifiziere ich mich?

Senden Sie den unveränderten sk-…-Schlüssel in x-api-key oder Authorization: Bearer: nur eines von beiden, nie beide. Bewahren Sie den Schlüssel in einer Umgebungsvariable auf, nicht in einer Datei, die ins Repository committet wird. Mehr zur Authentifizierung .

Wo bekomme ich einen Schlüssel?

Öffnen Sie Ihr Konto im Telegram-Bot @oneprovider_robot oder auf app.oneprovider.dev, laden Sie das Guthaben auf und tippen Sie auf „Schlüssel ausstellen“. Jeder Schlüssel kann ein eigenes Ausgabenlimit haben. Konto & API-Schlüssel .

Was bedeuten 401, 404 und 429?

401: Der Schlüssel fehlt, ist falsch geschrieben oder steht im falschen Header; fügen Sie den ganzen Schlüssel ohne Anführungszeichen und Leerzeichen ein. 404: meist eine falsche base URL, zum Beispiel ein fehlendes oder doppeltes /v1. 429 mit „Insufficient balance“: Das Guthaben des Kontos oder das Ausgabenlimit des Schlüssels ist aufgebraucht – laden Sie auf, statt es erneut zu versuchen; jedes andere 429 ist ein Rate-Limit, warten Sie dann die Zeit aus Retry-After ab. Details: Fehlercodes und Fehlerbehebung .

Warum brechen Streams ab oder werden zurückgesetzt?

VPN- und VLESS-Proxys puffern SSE oft oder stören die HTTP/2-Aushandlung. OneProvider hat keine regionalen Beschränkungen und puffert keine Streams – schalten Sie den Proxy aus und versuchen Sie es erneut.

Wohin wende ich mich, wenn das nicht reicht?

Schreiben Sie @Oneproviderhelpbot auf Telegram oder öffnen Sie „Support“ im Web-Konto – mit HTTP-Statuscode und genauer Fehlermeldung. So arbeitet der Support .