DillaStudio для разработчиков

Управляйте DillaStudio из Claude Code, Cursor и любых LLM-агентов через MCP — или напрямую через REST API. Генерация изображений и видео, редактирование, листинги: всё под вашим аккаунтом, с вашими кредитами и тарифом.

1. Получите API-ключ

Войдите в аккаунт и создайте ключ на странице Настройки → API-ключи. Ключ формата dilla_sk_… показывается один раз — сохраните его. При создании можно ограничить права (см. раздел «Права доступа» ниже).

Ключ передаётся в заголовке Authorization: Bearer dilla_sk_… и действует, пока вы его не отзовёте.

2. Подключите MCP к вашему агенту

Claude Code — одна команда, флаг --scope user делает сервер доступным во всех ваших проектах:

claude mcp add --transport http --scope user dillastudio \
  https://dillastudio.io/api/mcp \
  --header "Authorization: Bearer dilla_sk_ВАШ_КЛЮЧ"

Cursor и другие MCP-клиенты — тот же URL и заголовок в mcp.json:

{
  "mcpServers": {
    "dillastudio": {
      "url": "https://dillastudio.io/api/mcp",
      "headers": { "Authorization": "Bearer dilla_sk_ВАШ_КЛЮЧ" }
    }
  }
}

После подключения агент видит инструменты и вызывает их сам — просто попросите: «сгенерируй картинку через dillastudio» или «покажи баланс кредитов».

Инструмент	Что делает
`generate_image`	Генерация изображения (nano banana, Seedream 4.5 и др.). Синхронно, возвращает URL результата.
`generate_video`	Асинхронная генерация видео (Seedance). Возвращает task_id для опроса.
`get_video_status`	Статус видео-задачи: processing / completed / failed + URL готового видео.
`list_generations`	История ваших AI-генераций с URL.
`get_credits_balance`	Текущий тариф и баланс кредитов.
`remove_background`	Удаление фона у изображения. Синхронно.
`upscale_image`	Апскейл изображения ×2 или ×4.
`list_products`	Список ваших товаров.
`list_listings`	Список ваших листингов на маркетплейсе.
`create_listing`	Создание черновика листинга с дизайном.

Операции генерации и редактирования списывают кредиты по вашему тарифу — так же, как в веб-приложении.

REST API — без MCP

Тот же ключ работает как обычный Bearer-токен для API — удобно для скриптов и CI. Примеры:

# Баланс кредитов
curl https://dillastudio.io/api/billing/trial-status \
  -H "Authorization: Bearer dilla_sk_ВАШ_КЛЮЧ"

# Генерация изображения
curl -X POST https://dillastudio.io/api/studio-plus/generate \
  -H "Authorization: Bearer dilla_sk_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "минималистичный принт: кот-космонавт", "model": "nano_banana"}'

# История генераций
curl "https://dillastudio.io/api/studio-plus/generations?limit=10" \
  -H "Authorization: Bearer dilla_sk_ВАШ_КЛЮЧ"

Права доступа и безопасность

Скоуп	Доступ
`full` — Полный доступ	Все операции аккаунта.
`generate` — Генерации	Изображения и видео, статусы задач, история генераций.
`edit` — Редактирование	Апскейл, удаление фона и другие инструменты обработки.
`listings` — Товары и листинги	Чтение и создание товаров и листингов.
`read` — Только чтение	История, баланс, товары — без изменений.

Ключ даёт доступ к аккаунту в рамках выбранных прав — не публикуйте его и не коммитьте в git.
Отзыв ключа на странице настроек действует мгновенно.
Управление ключами и админ-операции по API-ключу недоступны — только из веб-интерфейса.
Секрет хранится у нас только в виде хэша: восстановить потерянный ключ нельзя, только создать новый.

Создать API-ключ Зарегистрироваться