Разработчикам · API v1

Один API. Все модели.

Изображения, видео, аудио и 3D за одним API, с тем же балансом, что и студия. Создайте ключ в настройках; CLI скоро появится.

СкороCLI Ducklygen уже в пути. Эта страница показывает, как она будет работать; пока пользуйтесь API.

$npm i -g @ducklygen/cli
Моделей
672
Эндпоинтов
9
Минимальное пополнение
3 €

Один вызов, любой результат

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

curl -X POST https://ducklygen.com/api/v1/api/catalog/generations \
  -H "Authorization: Bearer $DUCKLYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "modelId": "image-model-id",
  "inputs": {
    "prompt": "rubber duck floating on teal water, soft light"
  }
}'
Пример рендера

Первый рендер за три шага

  1. 1

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

    Войдите по email, откройте Настройки, API-ключи и создайте ключ. Пополнение от 3 € в разделе Оплата.

    export DUCKLYGEN_API_KEY="dk_live_..."
  2. 2

    CLI скоро появится

    Консольный инструмент ещё не опубликован. Пока всё работает в студии.

    npm i -g @ducklygen/cli
  3. 3

    Сделайте первый рендер

    Выберите ID модели в каталоге и отправьте промпт. Добавьте --dry-run, чтобы узнать цену, ничего не потратив.

    ducklygen run <model> -p "duck on teal waves" -o ./out/
СкороDucklygen CLI

Рендер из терминала

Запускайте любую модель из shell, CI или кодинг-агента. Цена каждого рендера известна до старта и списывается с того же баланса.

Скрипты и CIКаждое поле модели доступно как флаг; локальный файл загружается автоматически.
JSON в stdoutОдин JSON-документ на запуск, прогресс и ошибки в stderr, ненулевой код выхода при сбое.
Кодинг-агентыФайл навыка учит агента сначала проверять цену и ограничивать её.

Пакет @ducklygen/cli ещё не опубликован. Команды ниже показывают, как он будет работать.

Полное руководство по CLI →
Команда
ducklygen loginВставьте API-ключ один раз: он проверяется и сохраняется
ducklygen whoamiИмя ключа и ваш баланс
ducklygen models --type videoВсе видеомодели с начальной ценой
ducklygen run <model> -hПоля модели, загруженные в реальном времени: тип, значение по умолчанию, допустимые значения
ducklygen run <model> -p "<prompt>" -o ./out/Рендер с сохранением результата в папку
ducklygen run <model> -p "..." --dry-runТочная цена, ничего не тратится
ducklygen run <model> -p "..." --max-price 0.50Отказ от запуска, если цена выше
ducklygen run <model> -p "..." --json -o ./out/Один результат в JSON, готовый для следующего шага
ducklygen skill installНаучите кодинг-агента пользоваться CLI

Готов к продакшену

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

Bearer-токен в заголовке Authorization. Ключи создаются в Настройках, любой можно отозвать в любой момент.

Authorization: Bearer dk_live_...

Фоновые рендеры

Запуск рендера сразу отвечает статусом queued. Опрашивайте рендер, пока он не завершится успехом, ошибкой или возвратом.

{ "status": "queued" }

Сначала цена

Узнайте точную цену для своих параметров, ничего не запуская. Все суммы указаны в евроцентах.

POST /v1/quote

Безопасные повторы

Передайте заголовок Idempotency-Key, и повторный запрос никогда не спишет деньги дважды.

Idempotency-Key: render-042

Лимиты

У каждого ключа есть лимит в минуту и необязательный дневной потолок. Сверх лимита API отвечает 429.

429 Too Many Requests

Ошибки и возвраты

Ошибки в JSON с кодом и сообщением. Неудачный рендер автоматически возвращается на баланс.

{ "status": "refunded" }

Эндпоинты

Базовый URLhttps://ducklygen.com/api/v1/api/catalogПолный справочник API →

GET/meВаш ключ и баланс
GET/modelsВсе модели
GET/models/detail?id=MODEL_IDОдна модель и её поля
POST/quoteЦена для конкретных входных данных
POST/generationsЗапустить генерацию
GET/generationsВаши последние генерации
GET/generations/IDСтатус одной генерации
GET/generations/ID/contentФайл результата
DELETE/generations/IDУдалить генерацию

Пополните на 3 € и запускайтесь сегодня

Создайте API-ключ в настройках и вызывайте любую модель. CLI скоро появится. Неудачные рендеры возвращаются.