OneProvider
Руководства

Генерация видео

Создавайте видео по тексту или картинке через один API: отправьте запрос, проверьте статус, скачайте файл и узнайте точную цену за секунду для каждой модели.

Создайте видео по тексту или по картинке: запрос, статусы, скачивание и цена за секунду.

Все модели, характеристики и цены Индекс документации для AI-агентов: https://oneprovider.dev/docs/llms.txt

Доступные video-модели

kling-3.0 Runnable
720p, no sound
0,4872 $ / секунда
1080p, no sound
0,6496 $ / секунда
720p, with sound
0,7308 $ / секунда
1080p, with sound
0,9744 $ / секунда
720p · 1080p · 5–10s kling-3.0-omni Runnable
720p, no sound
0,546 $ / секунда
1080p, no sound
0,728 $ / секунда
720p, with sound
0,728 $ / секунда
1080p, with sound
0,91 $ / секунда
720p · 1080p · 5–10s kling-3.0-turbo Runnable
720p, sound included
0,63 $ / секунда
1080p, sound included
0,7875 $ / секунда
720p · 1080p · 5–10s

Как это работает

  1. Отправьте POST /v1/videos/generations с моделью, текстом и параметрами. В ответ придёт request_id.
  2. Видео делается асинхронно, обычно 1–3 минуты. Проверяйте статус раз в 10 секунд, пока он не станет done или failed.
  3. Когда статус done, скачайте файл по пути из поля video.url тем же ключом.

Запрос

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_..."}
Параметры запроса
ПолеЗначение
modelОбязательно. ID модели из таблицы выше.
promptОбязательно. Описание видео.
durationДлительность в секундах: 5 (по умолчанию) или 10.
resolution720p (по умолчанию) или 1080p.
aspect_ratio16:9 (по умолчанию) или 9:16.
audiotrue добавляет звук (цена секунды выше). В kling-3.0-turbo звук есть всегда.
imageСсылка на одну картинку для видео по изображению: {"url": "https://…"}. Доступно в kling-3.0-omni.

Сочетание, которого нет в таблице цен, отклоняется сразу с ошибкой 400, и ничего не списывается.

Статус

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}}
Статусы
statusЧто делать
pendingВидео ещё делается. Повторите запрос через 10 секунд.
doneГотово. Скачайте файл по video.url. В video.duration — длительность, за которую списана оплата.
failedВидео не получилось. Ничего не списывается; отправьте запрос заново.

Скачивание

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

Ответ — файл video/mp4; поддерживается заголовок Range. Сохраните файл у себя сразу: не рассчитывайте, что ссылка будет работать бесконечно.

Цена

Цена считается за секунду видео по строке таблицы выше (разрешение и звук). Списание происходит один раз, когда статус становится done; неудавшиеся и неготовые видео не оплачиваются.

Пример: kling-3.0, 720p, без звука, 5 секунд = 0,4872 $ × 5 = 2,436 $.

Ошибки

Коды ошибок
HTTPПричина
400Неверный параметр или сочетание параметров, которого нет в таблице цен.
401Ключ неверный или отозван.
402 / 403 / 429Недостаточно баланса или превышен лимит ключа. Пополните баланс и повторите.
404Нет такого request_id для этого ключа.
502Сервис видео временно недоступен. Ничего не списано; повторите запрос позже.
Один ключ — все модели Видео оплачивается с того же баланса, что и текст. Полную таблицу моделей и цен смотрите на странице Pricing .

Быстрые ответы

Какой base URL использовать?

Claude Code и Anthropic SDK работают с https://api.oneprovider.dev. OpenAI SDK и OpenAI-совместимые клиенты работают с https://api.oneprovider.dev/v1. За обоими адресами один ключ; список моделей: странице моделей , ставки на странице тарифов .

Как авторизоваться?

Передайте сырой ключ sk-… в заголовке x-api-key или Authorization: Bearer: один из двух, не оба. Храните ключ в переменной окружения, а не в файле, который попадает в репозиторий. Подробнее об аутентификации .

Где взять ключ?

Откройте кабинет в Telegram-боте @oneprovider_robot или на app.oneprovider.dev, пополните баланс и нажмите «Выпустить ключ». У каждого ключа может быть свой лимит расхода. Кабинет и ключи .

Что значат ошибки 401, 404 и 429?

401: ключ не задан, написан с ошибкой или передан не в том заголовке; вставьте ключ целиком, без кавычек и пробелов. 404: обычно неверный base URL, например лишний или двойной /v1. 429 с текстом «Insufficient balance»: баланс кабинета или лимит ключа исчерпан, пополните его вместо повторов; любой другой 429 это лимит частоты, подождите Retry-After. Разбор: коды ошибок и решение проблем .

Почему обрывается стрим или сбрасывается соединение?

VPN и VLESS-прокси часто буферизуют SSE или ломают согласование HTTP/2. У OneProvider нет региональных ограничений, и стримы на нашей стороне не буферизуются: отключите прокси и повторите запрос.

Куда писать, если не помогло?

Напишите в Telegram @Oneproviderhelpbot или откройте «Поддержку» в веб-кабинете: приложите код статуса и точный текст ошибки. Как работает поддержка .

Последнее обновление: 2026-10-18 Нашли ошибку? @Oneproviderhelpbot