Быстрый старт

Интеграция за пару минут

Подключите Outsee API сами по трём шагам — или поручите это своему ИИ-агенту.

Подключить через ИИ-агента

Скопируйте промпт и вставьте в Claude Code, Cursor, Codex или другой агент, который работает с вашим кодом. Он изучит проект, прочитает документацию и встроит Outsee API по вашим правилам.

Подключи Outsee API (генерация видео) к этому проекту.
Документация: https://outsee.io/platform/llms-full.txt — целиком одним файлом для LLM, https://outsee.io/platform/docs — для людей. Адреса, поля запросов и коды ошибок бери оттуда, а не из памяти.
1. Изучи проект: стек, серверная часть, где хранятся секреты, как устроены загрузка файлов и фоновые задачи.
2. Коротко скажи, куда встанет интеграция, и спроси, что будут делать мои пользователи: ролики по описанию, оживление фото, видео по референсам или правку роликов. Дальше работай по моему ответу.
3. Реализуй:
- Запросы к API — только с сервера: базовый адрес https://api.outsee.io/v1, заголовок Authorization: Bearer <ключ>. Ключ — в переменной окружения OUTSEE_API_KEY, в браузер и мобильное приложение он не попадает.
- Генерация асинхронная: запрос создания сразу возвращает id. Сохрани его вместе с пользователем и отдавай результат только владельцу. Готовность узнавай вебхуком (webhook_url — публичный https-адрес; подпись из заголовка Outsee-Signature проверяй секретом из переменной окружения OUTSEE_WEBHOOK_SECRET) или опросом GET /requests/{id} раз в 5–10 секунд. Пока проект запущен локально, вебхук до него не дойдёт — тогда опрос.
- Каждый запрос создания — с заголовком Idempotency-Key: новый UUID на действие пользователя и тот же при повторе, чтобы обрыв сети не создал второй ролик.
- Файлы пользователя передавай публичной https-ссылкой в поле запроса или загружай через POST /files.
- Ошибки разбирай по error.code (таблица в документации): на 429 повторяй после паузы из заголовка Retry-After, на 5xx — с тем же Idempotency-Key. Ошибки ключа, баланса и лимитов аккаунта (401, 402, 403) пользователю не показывай: запиши в лог и сообщи мне, а пользователю ответь, что сервис временно недоступен. Остальное показывай пользователю понятным текстом. Деньги за неудачный запрос возвращаются сами.
- Ссылка на готовый ролик живёт 30 дней — если он нужен дольше, сохрани файл в своё хранилище.
4. Добавь в пример окружения OUTSEE_API_KEY и, если используешь вебхук, OUTSEE_WEBHOOK_SECRET — оба значения я возьму в консоли Outsee, раздел «Ключи API». Цену запроса узнавай через POST /estimate/{модель}/{режим} — без списания. Пробный ролик оплачивается с баланса: назови его цену и запускай только после моего согласия. В конце расскажи, что изменилось и как попробовать.
1

Выпустите ключ

Войдите тем же аккаунтом, что на outsee.io, примите оферту и создайте ключ. Сохраните его в переменной окружения на сервере.

export OUTSEE_API_KEY="osk_live_…"
2

Пополните баланс

От 500 ₽ картой, через СБП или по счёту для организации. Цена запроса видна заранее, неудачные запросы не оплачиваются.

Пополнить баланс
3

Отправьте запрос

Создайте запрос — в ответ придёт его id. Затем получите результат опросом статуса или вебхуком.

Создать и дождаться
curl https://api.outsee.io/v1/bytedance/seedance-2.5/text-to-video \
-H "Authorization: Bearer $OUTSEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"prompt": "Кинематографичный проезд камеры вдоль побережья на закате, шум прибоя",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}'
Статус запроса
curl https://api.outsee.io/v1/requests/$REQUEST_ID \
-H "Authorization: Bearer $OUTSEE_API_KEY"