Александр
AI

Один ключ на видео, картинки и музыку: как подключить API нейросетей из России

Один ключ на видео, картинки и музыку: как подключить API нейросетей из России

Один ключ CyHUB открывает по API Seedance, Kling, Veo, GPT Image, Suno и другие модели для видео, картинок, музыки и 3D. Баланс в рублях, а цену запуска сервис называет до списания. Подключается всё быстро: аккаунт, ключ, проверочный запрос - и можно ставить задачи из своего сервиса, бота или скрипта.

Как получить ключ API

1. На сайте жмёте «Получить ключ API», откроется вход: через Telegram, MAX или по почте.

Один ключ на видео, картинки и музыку: как подключить API нейросетей из России

2. Вошли через мессенджер - добавьте в кабинете почту и подтвердите её ссылкой из письма. Без подтверждённой почты ключ не создать.

3. Раздел «API», вкладка «Ключи доступа», кнопка «Создать ключ».

Один ключ на видео, картинки и музыку: как подключить API нейросетей из России

4. Название - например, имя программы или сайта, где ключ будет работать. Жмёте «Создать».

Один ключ на видео, картинки и музыку: как подключить API нейросетей из России

5. Секрет ключа показывается один раз, сохраните его сразу же.

Храните ключ на сервере, в переменной окружения - не в коде страницы и не в открытом репозитории: по нему ведь списываются деньги. Ключ потерян или мог утечь - жмёте «Отозвать» и создаёте новый, старый перестаёт работать сразу. Активных ключей - до десяти, удобно держать по одному на проект.

Как пополнить баланс

Раздел «Баланс», кнопка «Пополнить» у рублёвого кошелька. Выбираете сумму и жмёте «Перейти к оплате», способ оплаты выбирается после создания счёта. Подписки нет, деньги списываются только за генерации.

Один ключ на видео, картинки и музыку: как подключить API нейросетей из России

Как проверить, что ключ работает

Первый запрос ничего не генерирует и денег не тратит, а показывает баланс:

curl "https://api.cyhub.ai/v1/me" \ -H "Authorization: Bearer YOUR_API_KEY"

Суммы в API - в копейках: available_minor: 15000 означает 150 ₽, доступных новым задачам. Ответ 401 invalid_api_key - ключ скопирован с ошибкой или уже отозван.

Как выбрать модель и узнать цену до запуска

Модели собраны в каталоге «Нейросети» на сайте. У каждой есть страница API: ключ модели для запроса, режимы с параметрами, готовый код на cURL, Python и Node.js и цены.

Один ключ на видео, картинки и музыку: как подключить API нейросетей из России

В таблице цены «от», а точная зависит от версии, качества и длины ролика. Её считает POST /v1/price: отправляете те же настройки, что и для запуска, задача не создаётся, деньги не трогаются, а в ответе amount_minor - цена в копейках. Цену задачи сервис пересчитывает в момент приёма, так что проверяйте её перед самым запуском.

Один ключ на видео, картинки и музыку: как подключить API нейросетей из России

Как запустить генерацию и забрать файл

Задача ставится одним запросом: ключ модели и её настройки. Полный цикл на Python - цена, задача, ожидание и скачивание - на примере Seedance 2.5 из документации:

import time import requests API = "https://api.cyhub.ai/v1" HEADERS = {"Authorization": "Bearer YOUR_API_KEY"} body = {"model": "seedance", "settings": { "mode": "text_to_video", "model": "seedance_2_5", "prompt": "Кот в очках играет на баяне на летней веранде, камера медленно наезжает", "quality": "720p", "duration": 8, "aspect_ratio": "16:9"}} price = requests.post(f"{API}/price", json=body, headers=HEADERS).json() input(f"Цена {price['amount_minor'] / 100} ₽. Enter - запустить, Ctrl+C - отмена ") task = requests.post(f"{API}/tasks", json=body, headers=HEADERS).json() while task["status"] in ("queued", "running"): time.sleep(5) task = requests.get(f"{API}/tasks/{task['id']}", headers=HEADERS).json() if task["status"] != "succeeded": raise SystemExit(task["error"]) for file in task["result"]["artifacts"]: data = requests.get(f"{API}/tasks/{task['id']}/artifacts/{file['index']}", headers=HEADERS) open(file["filename"], "wb").write(data.content)

При приёме задачи цена резервируется на балансе, а списывается только после статуса succeeded. Генерация упала или вы её отменили - резерв возвращается. Не хватает денег - ответ 402 insufficient_funds, и задача не создаётся вовсе.

Файлы результата хранятся 7 дней после завершения задачи, потом удаляются, а история остаётся. Скачивайте их сразу. Все задачи, запущенные через API, видны в кабинете: раздел «API», вкладка «Задачи», с фильтром по статусу и модели.

Как поручить интеграцию ИИ-агенту

Интеграцию можно отдать ИИ-агенту: Cursor, Claude Code, Codex или любой нейросети, которая пишет код. На каждой странице документации справа есть блок «Для ИИ-агентов»: «Эта страница в Markdown» отдаёт страницу файлом .md, а «Оглавление llms.txt» - карту всей документации со ссылками на страницы моделей.

Один ключ на видео, картинки и музыку: как подключить API нейросетей из России

Агенту хватает одной ссылки и задачи - вот как я это проверил: дал ему без всякой подготовки только адрес llms.txt. Он сам прошёл по нужным страницам, нашёл ключ модели и её параметры и собрал скрипт, который показывает цену, спрашивает подтверждение, ждёт результат и сохраняет файл. Повтор запроса при обрыве связи он тоже сделал через Idempotency-Key, как советует документация. Задача была такая:

Прочитай https://api.cyhub.ai/llms.txt и напиши на Python скрипт: он генерирует картинку в GPT Image 2.5 по моему описанию, перед запуском показывает цену в рублях и спрашивает подтверждение, потом ждёт результат и сохраняет файл рядом со скриптом. Ключ API бери из переменной окружения CYHUB_API_KEY.

Только сам ключ агенту не передавайте: пусть код читает его из переменной окружения, так же как в задаче выше.

Генерации прямо в чате: плагин MCP

Если нужен не код, а картинка или ролик прямо в разговоре с Claude или ChatGPT, есть плагин MCP. Ключ API ему не нужен: при подключении откроется сайт, вы входите в кабинет и жмёте «Разрешить». Тратит плагин тот же баланс, а лимиты на одну генерацию и на сутки ставятся в кабинете, во вкладке «Плагин MCP». Как подключить по шагам: в Claude и в ChatGPT.

Что чаще всего ломается

• 422 unknown_setting или invalid_settings - в settings поле, которого у модели нет, или значение не из списка. Сверяйтесь со страницей модели, что именно не так, написано в message.

• Референс по ссылке не принимается - ссылка должна отдавать сам файл без входа, а не страницу просмотра. Такой ссылки нет - загрузите файл через POST /v1/files и подставьте url из ответа.

• Если связь оборвалась, пока ставилась задача, повторите тот же запрос с тем же заголовком Idempotency-Key. Вернётся уже созданная задача, второй генерации и второго списания не будет.

• 429 rate_limited или too_many_active - превышен лимит запросов (120 в минуту на кабинет) или одновременных задач одной модели. Подождите и повторите.

• 503 model_unavailable - модель на обслуживании. Заранее это видно по полю available в GET /v1/models.

Частые вопросы

Нужен ли отдельный ключ под каждую модель? Нет. Один ключ открывает все модели, меняется только поле model в запросе.

Спишутся ли деньги, если генерация не удалась? Нет. Резерв возвращается на баланс при ошибке и при отмене, повторный запуск - это новая задача.

Можно ли узнать цену, ничего не запуская? Да, запросом POST /v1/price с теми же настройками. Задача не создаётся.

Чем API отличается от плагина MCP? API - для своих программ, сайтов и ботов, нужен ключ. Плагин - для генераций в чате с Claude или ChatGPT, ключ ему не нужен.

Документация, каталог моделей с ценами и вход в кабинет - на api.cyhub.ai. Какую модель вы подключаете первой: видео, картинки или звук?

#нейросети #api #cyhub