# CyHUB API

> Генерация картинок, видео и аудио через HTTP API теми же моделями и по тем же ценам, что в ботах Cyber AI. Один ключ на все модели, оплата с баланса кабинета.

Адрес API: https://api.cyhub.ai/v1. В каждом запросе заголовок `Authorization: Bearer <ключ>`. Ключ создаётся в кабинете (https://cyhub.ai/cabinet/keys) после подтверждения почты.

Порядок работы: выбрать модель (GET /v1/models), узнать поля её настроек (GET /v1/models/{model_key}), при желании узнать цену (POST /v1/price), поставить задачу (POST /v1/tasks), опрашивать её (GET /v1/tasks/{id}) до статуса succeeded и скачать файлы результата.

Ошибка приходит в виде `{"error": {"code", "message"}}`: ветвиться нужно по code, а message показывать человеку. Язык текстов: ?lang=ru или ?lang=en либо заголовок Accept-Language, без них русский.

У каждой страницы документации есть версия в Markdown: добавьте .md к её адресу, например https://api.cyhub.ai/docs/tasks.md.

Этот файл на английском: https://api.cyhub.ai/llms.txt?lang=en

## Документация

- [Старт](https://api.cyhub.ai/docs.md?lang=ru): Первый запрос к API CyHUB.
- [Подключение](https://api.cyhub.ai/docs/connection.md?lang=ru): Ключ API, адрес запросов и баланс.
- [Запуск генерации](https://api.cyhub.ai/docs/generations.md?lang=ru): Модель и настройки в одном запросе, цена и безопасные повторы.
- [Плагин MCP](https://api.cyhub.ai/docs/plugin.md?lang=ru): Генерации CyHUB в Claude и ChatGPT: адрес и подключение.
- [Задачи и результаты](https://api.cyhub.ai/docs/tasks.md?lang=ru): Статусы, результат и история задач.
- [Файлы](https://api.cyhub.ai/docs/files.md?lang=ru): Референсы по ссылке, загрузка своих файлов и скачивание результатов.
- [Ошибки и лимиты](https://api.cyhub.ai/docs/errors.md?lang=ru): Что делать, если запрос не выполнился.

## Модели

- [Seedance 2.5 API](https://api.cyhub.ai/models/seedance-2-5/api.md): Видео Seedance 2.5 от ByteDance со звуком: по описанию, по первому и последнему кадру или по референсам, до 30 секунд. Референсы: фото, видео и аудио, качество до 1080p. Своё видео можно отредактировать описанием или продлить вперёд или назад. Два канала: обычный и, как правило, подешевле. На Канале 2 можно сначала снять черновик в 480p, а понравившийся один раз пересобрать в 1080p. ([о модели](https://api.cyhub.ai/models/seedance-2-5))
- [Seedance 2.0 API](https://api.cyhub.ai/models/seedance-2/api.md): Видео Seedance 2.0 от ByteDance со звуком: по описанию, по первому и последнему кадру или по референсам, до 15 секунд. Референсы: фото, видео и аудио. Своё видео можно отредактировать описанием, а на Канале 2 и продлить вперёд или назад. Единственная версия Seedance с 4K. Два канала: обычный и, как правило, подешевле. ([о модели](https://api.cyhub.ai/models/seedance-2))
- [Seedance 2.0 Fast API](https://api.cyhub.ai/models/seedance-2-fast/api.md): Видео Seedance 2.0 Fast от ByteDance со звуком: по описанию, по первому и последнему кадру или по референсам, до 15 секунд. Быстрая версия, качество 480p или 720p. Референсы: фото, видео и аудио. Своё видео можно отредактировать описанием, а на Канале 2 и продлить вперёд или назад. Два канала: обычный и, как правило, подешевле. ([о модели](https://api.cyhub.ai/models/seedance-2-fast))
- [Seedance 2.0 Mini API](https://api.cyhub.ai/models/seedance-2-mini/api.md): Видео Seedance 2.0 Mini от ByteDance со звуком: по описанию, по первому и последнему кадру или по референсам, до 15 секунд. Самая дешёвая версия Seedance, качество 480p или 720p. Референсы: фото, видео и аудио. Своё видео можно отредактировать описанием, а на Канале 2 и продлить вперёд или назад. Два канала: обычный и, как правило, подешевле. ([о модели](https://api.cyhub.ai/models/seedance-2-mini))
- [Suno V6 API](https://api.cyhub.ai/models/suno/api.md): Песни и звуки Suno V6 с нуля по описанию или со своим текстом: за один запуск два варианта трека в MP3. По вашему аудио: добавить вокал или музыку, кавер, продолжение, замена куска, ремикс двух треков. Есть ещё версии V6 Mini и V6 Wild. ([о модели](https://api.cyhub.ai/models/suno))
- [GPT Image 2.5 API](https://api.cyhub.ai/models/gpt-image-2-5/api.md): Картинки GPT Image 2.5 от OpenAI по описанию и по референсам (до 16), до 4K и с прозрачным фоном. Два варианта, Flare и Sunburst, с одинаковыми настройками: тринадцать пропорций и три ступени качества. Описание обязательно. ([о модели](https://api.cyhub.ai/models/gpt-image-2-5))
- [GPT Image 2 API](https://api.cyhub.ai/models/gpt-image-2/api.md): Картинки GPT Image 2 от OpenAI по описанию и по референсам (до 14), до 4K. Шесть пропорций, результат PNG. Описание можно не давать, если есть референсы. ([о модели](https://api.cyhub.ai/models/gpt-image-2))
- [GPT Image 1.5 API](https://api.cyhub.ai/models/gpt-image-1-5/api.md): Картинки GPT Image 1.5 от OpenAI по описанию и по референсам (до 14). Три пропорции и одно разрешение, результат PNG. Описание можно не давать, если есть референсы. ([о модели](https://api.cyhub.ai/models/gpt-image-1-5))
- [ElevenLabs API](https://api.cyhub.ai/models/elevenlabs/api.md): Голоса ElevenLabs: озвучка текста и диалогов готовыми голосами, смена голоса в своей записи и дубляж записи на другой язык. ([о модели](https://api.cyhub.ai/models/elevenlabs))
- [Nano Banana Pro API](https://api.cyhub.ai/models/nano-banana-pro/api.md): Картинки Nano Banana Pro от Google по описанию и правка ваших картинок: до 8 референсов, качество до 4K. Десять пропорций, результат PNG или JPG. ([о модели](https://api.cyhub.ai/models/nano-banana-pro))
- [Nano Banana 2.1 API](https://api.cyhub.ai/models/nano-banana-2-1/api.md): Картинки Nano Banana 2.1 от Google по описанию и правка ваших картинок: до 10 референсов, качество до 4K. Четырнадцать пропорций, включая вытянутые 1:4, 4:1, 1:8 и 8:1, и «Авто», результат PNG или JPG. ([о модели](https://api.cyhub.ai/models/nano-banana-2-1))
- [Nano Banana 2 API](https://api.cyhub.ai/models/nano-banana-2/api.md): Картинки Nano Banana 2 от Google с широким выбором пропорций, включая вытянутые 1:4, 4:1, 1:8 и 8:1. По описанию и правка ваших картинок (до 10 референсов), качество до 4K. Можно разрешить модели искать в Google актуальные факты и реальные места. ([о модели](https://api.cyhub.ai/models/nano-banana-2))
- [Nano Banana 2 Lite API](https://api.cyhub.ai/models/nano-banana-2-lite/api.md): Быстрые картинки Banana 2 Lite по описанию, можно с картинками-образцами для правки или стиля. Разрешение всегда 1K. ([о модели](https://api.cyhub.ai/models/nano-banana-2-lite))
- [Kling 3.0 API](https://api.cyhub.ai/models/kling-3/api.md): Видео Kling 3.0 по описанию или по первому и последнему кадру: от 3 до 15 секунд, до 4K, с озвучкой. Ролик можно разбить на несколько сцен, модель сама поделит описание. ([о модели](https://api.cyhub.ai/models/kling-3))
- [Kling 2.6 API](https://api.cyhub.ai/models/kling-2-6/api.md): Видео Kling 2.6 с озвучкой: голоса, звуки и музыка под видео. По описанию или по первому и последнему кадру, 5 или 10 секунд, 720p или 1080p. ([о модели](https://api.cyhub.ai/models/kling-2-6))
- [Kling 2.5 Turbo API](https://api.cyhub.ai/models/kling-2-5-turbo/api.md): Видео Kling 2.5 Turbo: быстрая версия с реалистичной физикой и звуковыми эффектами. По описанию или по первому и последнему кадру, 5 или 10 секунд, 720p или 1080p. ([о модели](https://api.cyhub.ai/models/kling-2-5-turbo))
- [Kling 2.1 Master API](https://api.cyhub.ai/models/kling-2-1-master/api.md): Видео Kling 2.1 Master с кинематографичным движением и звуковыми эффектами, только 1080p. По описанию или из вашей картинки, 5 или 10 секунд, последнего кадра нет. ([о модели](https://api.cyhub.ai/models/kling-2-1-master))
- [Kling 2.1 API](https://api.cyhub.ai/models/kling-2-1/api.md): Видео Kling 2.1 из вашей картинки: первый кадр обязателен, последний можно добавить. 5 или 10 секунд, 720p или 1080p, звуковые эффекты. ([о модели](https://api.cyhub.ai/models/kling-2-1))
- [Kling 1.6 API](https://api.cyhub.ai/models/kling-1-6/api.md): Видео Kling 1.6: стабильная версия с выразительной мимикой и звуковыми эффектами. По описанию или по первому и последнему кадру, 5 или 10 секунд, 720p или 1080p. ([о модели](https://api.cyhub.ai/models/kling-1-6))
- [Kling Motion 3.0 API](https://api.cyhub.ai/models/kling-motion/api.md): Видео Kling Motion 3.0: человек с вашего фото повторяет движения из вашего видео. Версия 3.0 точнее передаёт сложные движения и лицо, 720p или 1080p. Звук из видео с движениями можно оставить. ([о модели](https://api.cyhub.ai/models/kling-motion))
- [Kling Motion 2.6 API](https://api.cyhub.ai/models/kling-motion-2-6/api.md): Видео Kling Motion 2.6: человек с вашего фото повторяет движения из вашего видео. Проверенная и более дешёвая версия, 720p или 1080p. ([о модели](https://api.cyhub.ai/models/kling-motion-2-6))
- [Midjourney 8.2 API](https://api.cyhub.ai/models/midjourney/api.md): Картинки Midjourney 8.2 по описанию и по вашим фото: перенос человека или предмета в новую сцену, правка фото словами. Сетка из четырёх вариантов, картинки-подсказки и образцы стиля. Можно выбрать и предыдущую версию 8.1. ([о модели](https://api.cyhub.ai/models/midjourney))
- [Midjourney Editor API](https://api.cyhub.ai/models/midjourney-editor/api.md): Midjourney Editor правит вашу картинку: прозрачные места PNG Midjourney перерисует по описанию. Убрать лишнее, заменить фон или предмет, расширить кадр, остальное останется как было. ([о модели](https://api.cyhub.ai/models/midjourney-editor))
- [Midjourney 7 API](https://api.cyhub.ai/models/midjourney-7/api.md): Картинки Midjourney 7 по описанию и перенос человека, персонажа или предмета с фото в новую картинку. Сетка из четырёх вариантов, картинки-подсказки и образцы стиля. Запуск с переносом дороже обычного. ([о модели](https://api.cyhub.ai/models/midjourney-7))
- [Veo 3.1 API](https://api.cyhub.ai/models/veo-3-1/api.md): Видео Veo 3.1 со звуком: по описанию, по кадрам или по референсам, три уровня качества. ([о модели](https://api.cyhub.ai/models/veo-3-1))
- [Wan 3.0 API](https://api.cyhub.ai/models/wan-3/api.md): Видео Wan 3.0 по первому и последнему кадру, по референсам и в режиме Omni, где картинки, видео и звук идут вместе. От 2 до 30 секунд, до 1080p. ([о модели](https://api.cyhub.ai/models/wan-3))
- [Wan 2.7 API](https://api.cyhub.ai/models/wan-2-7/api.md): Видео Wan 2.7 по описанию, по первому и последнему кадру или по референсам с персонажами, предметами и местами. От 2 до 15 секунд, 720p или 1080p, можно добавить свой звук и разбить ролик на сцены. ([о модели](https://api.cyhub.ai/models/wan-2-7))
- [Wan 2.6 API](https://api.cyhub.ai/models/wan-2-6/api.md): Видео Wan 2.6 по описанию или по первому и последнему кадру. От 2 до 15 секунд, 720p или 1080p, можно добавить свой звук и разбить ролик на сцены. ([о модели](https://api.cyhub.ai/models/wan-2-6))
- [Wan 2.5 API](https://api.cyhub.ai/models/wan-2-5/api.md): Видео Wan 2.5 по описанию или по первому и последнему кадру: 5 или 10 секунд, от 480p до 1080p. ([о модели](https://api.cyhub.ai/models/wan-2-5))
- [MiniMax H3 (Hailuo 03) API](https://api.cyhub.ai/models/minimax-h3/api.md): Видео MiniMax H3 (Hailuo 03) со звуком, до 15 секунд: по описанию, по первому и последнему кадру или по референсам. Референсы: картинки, видео и аудио. Качество 768P или 2K, звук модель пишет сама. ([о модели](https://api.cyhub.ai/models/minimax-h3))
- [Gemini Omni API](https://api.cyhub.ai/models/gemini-omni/api.md): Видео Gemini Omni по описанию: с картинками, исходным видео и голосом или от первого кадра к последнему. ([о модели](https://api.cyhub.ai/models/gemini-omni))
- [Grok Imagine Video API](https://api.cyhub.ai/models/grok-video/api.md): Видео Grok: по описанию, из картинки или по референсам, правка и продолжение вашего ролика. Две модели: Grok с роликами до 30 секунд и Grok Pro. ([о модели](https://api.cyhub.ai/models/grok-video))
- [Grok Imagine 2.0 API](https://api.cyhub.ai/models/grok-imagine-2/api.md): Картинки Grok Imagine 2.0 от xAI по текстовому описанию, пять вариантов пропорций. ([о модели](https://api.cyhub.ai/models/grok-imagine-2))
- [FLUX 3 API](https://api.cyhub.ai/models/flux-3/api.md): Видео FLUX 3 со звуком до 20 секунд: по описанию, по кадрам или продолжение готового ролика. Черновик стоит примерно треть полного видео. ([о модели](https://api.cyhub.ai/models/flux-3))
- [Vidu Q3 API](https://api.cyhub.ai/models/vidu-q3/api.md): Видео Vidu Q3 со звуком до 16 секунд и до 1080p: по описанию, из одного кадра, по первому и последнему кадру или по референсам. ([о модели](https://api.cyhub.ai/models/vidu-q3))
- [HappyHorse 1.1 API](https://api.cyhub.ai/models/happyhorse/api.md): Видео HappyHorse: по описанию, из картинки, по картинкам-референсам или правка готового ролика. ([о модели](https://api.cyhub.ai/models/happyhorse))
- [HeyGen Lip Sync API](https://api.cyhub.ai/models/heygen-lip-sync/api.md): HeyGen LipSync: новая звуковая дорожка для готового видео, губы человека в кадре двигаются под неё. ([о модели](https://api.cyhub.ai/models/heygen-lip-sync))
- [Seedream 5.0 API](https://api.cyhub.ai/models/seedream-5/api.md): Картинки Seedream 5.0 по описанию и по референсам (до 14), качество 2K или 3K. Результат PNG или JPEG. ([о модели](https://api.cyhub.ai/models/seedream-5))
- [Seedream 5.0 PRO API](https://api.cyhub.ai/models/seedream-5-pro/api.md): Картинки Seedream 5.0 PRO по описанию и по референсам (до 10), качество 1K или 2K. Ещё она разбирает картинку на слои с прозрачностью и правит картинку PNG с прозрачным фоном, сохраняя прозрачность. ([о модели](https://api.cyhub.ai/models/seedream-5-pro))
- [Seedream 4.5 API](https://api.cyhub.ai/models/seedream-4-5/api.md): Картинки Seedream 4.5 по описанию и по референсам (до 14), качество 2K или 4K. Предыдущая версия, результат всегда JPEG. ([о модели](https://api.cyhub.ai/models/seedream-4-5))
- [Recraft API](https://api.cyhub.ai/models/recraft/api.md): Картинки Recraft и настоящий вектор SVG по описанию, версии V4.1 и V4.1 Pro. Правка вашей картинки: замена и стирание области по маске, расширение кадра, замена фона. Ещё похожие варианты, перевод в вектор, удаление фона и апскейл. ([о модели](https://api.cyhub.ai/models/recraft))
- [Recraft V3 API](https://api.cyhub.ai/models/recraft-v3/api.md): Картинки Recraft V3 с готовыми стилями и настоящий вектор SVG по описанию: логотипы, иконки, плоские иллюстрации. Стили: фотореализм или иллюстрация. До 6 штук за один запуск. ([о модели](https://api.cyhub.ai/models/recraft-v3))
- [Recraft V2 API](https://api.cyhub.ai/models/recraft-v2/api.md): Картинки Recraft V2 и настоящий вектор SVG по описанию: логотипы, иконки, плоские иллюстрации. Самый дешёвый движок Recraft, с готовыми стилями: фотореализм или иллюстрация. До 6 штук за один запуск. ([о модели](https://api.cyhub.ai/models/recraft-v2))
- [Eleven Music API](https://api.cyhub.ai/models/eleven-music/api.md): Музыка Eleven Music от ElevenLabs: трек по описанию с вокалом или без, музыка под ваш ролик и разбор готовой записи на дорожки. ([о модели](https://api.cyhub.ai/models/eleven-music))
- [Eleven Music v2 API](https://api.cyhub.ai/models/eleven-music-v2/api.md): Музыка Eleven Music v2 от ElevenLabs: трек по описанию с вокалом или без и фоновая музыка под ваш ролик. Трек до 10 минут, можно приложить образец звучания. ([о модели](https://api.cyhub.ai/models/eleven-music-v2))
- [Tripo 3D API](https://api.cyhub.ai/models/tripo-3d/api.md): 3D-модели Tripo по описанию, по одному фото или по нескольким ракурсам объекта. ([о модели](https://api.cyhub.ai/models/tripo-3d))
- [Tripo 3.0 API](https://api.cyhub.ai/models/tripo-3-0/api.md): 3D-модели Tripo 3.0 по описанию, по одному фото или по нескольким ракурсам объекта. Максимальная детализация и все настройки модели. ([о модели](https://api.cyhub.ai/models/tripo-3-0))
- [Tripo 2.5 API](https://api.cyhub.ai/models/tripo-2-5/api.md): 3D-модели Tripo 2.5 по описанию, по одному фото или по нескольким ракурсам объекта. Прежняя стабильная версия, часть настроек у неё недоступна. ([о модели](https://api.cyhub.ai/models/tripo-2-5))

## Страницы сайта

- [Нейросети](https://api.cyhub.ai/models): все нейросети с возможностями и ссылками на их API
- [Цены](https://api.cyhub.ai/pricing): цены моделей

## Справочник API

- [OpenAPI](https://api.cyhub.ai/v1/openapi.json): OpenAPI 3: все эндпоинты, параметры и формы ответов
- [GET /v1/models](https://api.cyhub.ai/v1/models): Список моделей: ключ, название, тип результата и доступность
- [GET /v1/models/schemas](https://api.cyhub.ai/v1/models/schemas?lang=ru): Все модели одним запросом: JSON Schema настроек и документация на языке запроса

## Optional

- [llms-full.txt](https://api.cyhub.ai/llms-full.txt?lang=ru): Вся документация одним файлом