OneProvider

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
720p · 1080p · 5–10s 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
720p · 1080p · 5–10s

Jak to działa

  1. Wyślij POST /v1/videos/generations z modelem, promptem i opcjami. Odpowiedź zawiera request_id.
  2. Wideo powstaje asynchronicznie, zwykle w 1–3 minuty. Sprawdzaj status co 10 sekund, aż będzie done lub failed.
  3. Gdy status to done, pobierz plik ze ścieżki w video.url tym samym kluczem.

Żądanie

bash
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_..."}
Parametry żądania
PoleWartość
modelWymagane. Identyfikator modelu z tabeli powyżej.
promptWymagane. Opis wideo.
durationDługość w sekundach: 5 (domyślnie) lub 10.
resolution720p (domyślnie) lub 1080p.
aspect_ratio16:9 (domyślnie) lub 9:16.
audiotrue 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

bash
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}}
Statusy
statusCo robić
pendingWideo jest jeszcze tworzone. Zapytaj ponownie za 10 sekund.
doneGotowe. Pobierz plik z video.url. video.duration to długość, za którą naliczono opłatę.
failedNie udało się utworzyć wideo. Opłata nie jest naliczana; wyślij żądanie ponownie.

Pobieranie

bash
curl -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

Kody błędów
HTTPPrzyczyna
400Nieprawidłowe pole lub kombinacja, której nie ma w tabeli cen.
401Klucz jest nieprawidłowy lub unieważniony.
402 / 403 / 429Za niskie saldo albo osiągnięty limit klucza. Doładuj i spróbuj ponownie.
404Brak takiego request_id dla tego klucza.
502Usługa wideo jest chwilowo niedostępna. Opłata nie została naliczona; spróbuj ponownie później.
Jeden klucz do każdego modelu Wideo opłacasz z tego samego salda co tekst. Pełną tabelę modeli i cen znajdziesz na stronie z cennikiem .

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