Перейти к содержимому
DER.run
В студию

API

API для генерации изображений и видео

Модели и инструменты студии доступны по HTTPS с API-ключом: читайте каталог моделей, отправляйте генерации, опрашивайте их статус и скачивайте результаты. Или подключите DER к своему ИИ-агенту через MCP.

Получить API-ключПодключить ИИ-агента
  • АутентификацияAPI-ключ (Bearer)
  • Модели и инструменты55 в каталоге
  • Опрос статусаКаждые 5–30 с
  • Цены1 кредит = 0,01 $

Два способа

REST для кода, MCP для агентов

REST API

https://api.der.run/v1

Для вашего кода. Отправьте генерацию, опрашивайте её статус, скачайте результат.

  • GET/v1/capabilitiesВсе модели с параметрами, слотами загрузки, режимом цены и интервалом опроса
  • POST/v1/quotesРасчёт цены генерации до отправки
  • POST/v1/uploadsНачать загрузку, затем отправить файл методом PUT на полученный адрес
  • POST/v1/uploads/{id}/completeЗавершить загрузку и получить id файла для входных данных
  • POST/v1/jobsОтправить генерацию · нужен Idempotency-Key
  • GET/v1/jobsВаши генерации, сначала новые, до 100 на странице
  • GET/v1/jobs/{id}Статус генерации
  • GET/v1/jobs/{id}/assets/{index}Скачать результат по закрытой ссылке, которая действует около часа

MCP-сервер и навык DER

https://api.der.run/mcp

Для ИИ-агентов вроде Claude Code, Cursor и Codex. Добавьте адрес, войдите в аккаунт DER и просто пишите, что нужно.

  • der_list_modelsМодели, цены и ограничения
  • der_quoteРасчёт стоимости до запуска (бесплатно)
  • der_create_jobЗапустить задание: видео, изображение, AIdol, замена лица или музыка
  • der_get_jobСтатус и ссылки на результат
  • der_get_resultsСсылки для скачивания
  • + ещё 13 инструментов в MCP-сервере
Настроить ИИ-агента

Аутентификация

Один ключ — весь ваш аккаунт

Передавайте API-ключ как Bearer-токен. Ключ действует от имени вашего аккаунта: те же кредиты, тот же уровень. Срок действия ключа — до 366 дней; создавайте и отзывайте ключи в разделе «API-ключи». Одновременно можно иметь до 10 ключей.

HTTP-заголовок
# в каждом запросе
Authorization: Bearer der_user_…

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

Первая генерация за три шага

  1. Создайте API-ключ

    В студии, в разделе «API-ключи». Ключ показывается один раз — сохраните его в надёжном месте.

    Открыть API-ключи

  2. Прочитайте каталог

    GET /v1/capabilities возвращает все модели с параметрами, слотами загрузки, режимом цены и интервалом опроса.

    Терминал
    curl "https://api.der.run/v1/capabilities" \
  -H "Authorization: Bearer $DER_API_KEY"

  3. Отправьте и опрашивайте

    Сначала загрузите фото, затем отправьте POST /v1/jobs с Idempotency-Key и опрашивайте GET /v1/jobs/{id}, пока генерация не завершится. Повторная отправка с тем же ключом возвращает ту же генерацию.

    Терминал
    curl -X POST "https://api.der.run/v1/jobs" \
  -H "Authorization: Bearer $DER_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "der-v2",
    "params": {
      "prompt": "…"
    },
    "inputs": {
      "image": "<asset id>"
    }
  }'

curl "https://api.der.run/v1/jobs/{id}" \
  -H "Authorization: Bearer $DER_API_KEY"

Полезно знать

Перед запуском в продакшен

  • Результаты закрыты

    В REST результаты скачиваются с вашим ключом: GET /v1/jobs/{id}/assets/{index} перенаправляет на закрытую ссылку, которая действует около часа. Публичных ссылок нет, и инструменты MCP выдают такие же ссылки. Результаты и загруженные файлы хранятся 7 дней, затем автоматически удаляются.

  • Списки разбиты на страницы

    GET /v1/jobs возвращает до 100 генераций, сначала новые. Чтобы получить более старые, передайте next_before в параметре before; фильтровать можно по модели, типу результата или состоянию.

  • Цены

    У некоторых моделей в каталоге фиксированная цена, у остальных цена рассчитывается при отправке. POST /v1/quotes заранее сообщает цену.

  • Уровни

    Некоторым моделям нужен аккаунт Pro или Max. Запрос к такой модели с более низкого уровня получает ответ 403.

  • Те же кредиты

    API тратит те же кредиты, что и студия. За неудачные генерации кредиты возвращаются автоматически.

  • Опрашивайте в темпе модели

    У каждой модели в каталоге свой poll_seconds. На слишком частые запросы приходит ответ 429 с заголовком Retry-After.

Для ИИ-агентов

Пользуйтесь DER из Claude Code, Cursor или Codex

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

Открыть инструкцию для ИИ-агентов