Generowanie wideo
Twórz wideo z tekstu lub obrazu przez jedno API: wyślij zapytanie, sprawdzaj status, pobierz plik i zobacz dokładną cenę za sekundę dla każdego modelu.
Tworzenie wideo z tekstu: żądanie, statusy, pobieranie i cena za sekundę.
Wszystkie modele, możliwości i ceny Indeks dokumentacji dla agentów AI:https://oneprovider.dev/docs/llms.txt Dostępne modele wideo
kling-3.0 Dostępny - 720p, bez dźwięku
- 0,672 USD / sekunda
- 1080p, bez dźwięku
- 0,896 USD / sekunda
- 720p, z dźwiękiem
- 1,008 USD / sekunda
- 1080p, z dźwiękiem
- 1,344 USD / sekunda
kling-3.0-turbo Dostępny - 720p, z dźwiękiem w cenie
- 0,896 USD / sekunda
- 1080p, z dźwiękiem w cenie
- 1,12 USD / sekunda
Jak to działa
- Wyślij
POST /v1/videos/generationsz modelem, promptem i opcjami. Odpowiedź zawierarequest_id. - Wideo powstaje asynchronicznie, zwykle w 1–3 minuty. Sprawdzaj status co 10 sekund, aż będzie done lub failed.
- Gdy status to
done, pobierz plik ze ścieżki wvideo.urltym samym kluczem.
Żądanie
bashcurl -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_..."} | Pole | Wartość |
|---|---|
model | Wymagane. Identyfikator modelu z tabeli powyżej. |
prompt | Wymagane. Opis wideo. |
duration | Długość w sekundach: 5 (domyślnie) lub 10. |
resolution | 720p (domyślnie) lub 1080p. |
aspect_ratio | 16:9 (domyślnie) lub 9:16. |
audio | true dodaje dźwięk (wyższa cena za sekundę). kling-3.0-turbo zawsze zawiera dźwięk. |
Kombinacja, której nie ma w tabeli cen, jest od razu odrzucana błędem 400 i nie jest naliczana żadna opłata.
Status
bashcurl -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}} | status | Co robić |
|---|---|
pending | Wideo jest jeszcze tworzone. Zapytaj ponownie za 10 sekund. |
done | Gotowe. Pobierz plik z video.url. video.duration to długość, za którą naliczono opłatę. |
failed | Nie udało się utworzyć wideo. Opłata nie jest naliczana; wyślij żądanie ponownie. |
Pobieranie
bashcurl -sS https://api.oneprovider.dev/v1/videos/generations/$REQUEST_ID/content \
-H "Authorization: Bearer $ONEPROVIDER_KEY" \
-o video.mp4 Odpowiedzią jest plik video/mp4, a nagłówek Range jest obsługiwany. Zapisz plik u siebie od razu; nie licz na to, że link będzie działał w nieskończoność.
Cennik
Płacisz za sekundę wideo według stawki z pasującego wiersza tabeli powyżej (rozdzielczość i dźwięk). Opłata jest pobierana jednorazowo, gdy status zmieni się na done; nieudane lub niedokończone wideo nie jest rozliczane.
Przykład: kling-3.0, 720p, bez dźwięku, 5 sekund = 0,672 USD × 5 = 3,36 USD.
Błędy
| HTTP | Przyczyna |
|---|---|
| 400 | Nieprawidłowe pole lub kombinacja, której nie ma w tabeli cen. |
| 401 | Klucz jest nieprawidłowy lub unieważniony. |
| 402 / 403 / 429 | Za niskie saldo albo osiągnięty limit klucza. Doładuj i spróbuj ponownie. |
| 404 | Brak takiego request_id dla tego klucza. |
| 502 | Usługa wideo jest chwilowo niedostępna. Opłata nie została naliczona; spróbuj ponownie później. |
Szybkie odpowiedzi
Jakiego base URL użyć?
Claude Code i SDK Anthropic używają https://api.oneprovider.dev. SDK OpenAI i klienty zgodne z OpenAI używają https://api.oneprovider.dev/v1. Jeden klucz działa przy obu; lista modeli jest na stronie modeli , a stawki na stronie cennika .
Jak się uwierzytelnić?
Wyślij surowy klucz sk-… w x-api-key albo Authorization: Bearer: w jednym z nich, nigdy w obu. Trzymaj klucz w zmiennej środowiskowej, a nie w pliku, który trafia do repozytorium. Więcej o uwierzytelnianiu .
Skąd wziąć klucz?
Otwórz swój Panel w bocie Telegram @oneprovider_robot lub na app.oneprovider.dev, doładuj saldo i naciśnij „Utwórz klucz”. Każdy klucz może mieć własny limit wydatków. Panel i klucze API .
Co oznaczają 401, 404 i 429?
401: klucza brakuje, jest błędnie wpisany albo wysłany w złym nagłówku; wklej cały klucz bez cudzysłowów i spacji. 404: zwykle zły base URL, na przykład brakujące lub podwojone /v1. 429 z komunikatem „Insufficient balance”: saldo Panelu lub limit wydatków klucza się wyczerpał, więc doładuj zamiast ponawiać; każde inne 429 to limit zapytań, więc poczekaj zgodnie z Retry-After. Szczegóły: kody błędów i rozwiązywanie problemów .
Dlaczego strumienie się urywają lub resetują?
VPN i proxy VLESS często buforują SSE albo zrywają negocjację HTTP/2. OneProvider nie ma ograniczeń regionalnych i nie buforuje strumieni, więc wyłącz proxy i spróbuj ponownie.
Gdzie pytać, jeśli to nie wystarcza?
Napisz do @Oneproviderhelpbot w Telegramie albo otwórz „Wsparcie” w Panelu w przeglądarce, podając kod statusu HTTP i dokładny komunikat błędu. Jak działa wsparcie .
Ostatnia aktualizacja: 2026-11-08 Widzisz błąd? @Oneproviderhelpbot