Dropstone Support

Использование API с вашим тарифным планом

Вызывайте Dropstone по HTTP с помощью API-ключа. Эндпоинт совместим с OpenAI, оплата по мере использования с вашего кредитного баланса, работает из любого языка. Ключи, ошибки, лимиты запросов и что API не поддерживает.

API Dropstone — это эндпоинт, совместимый с OpenAI, для кода, который не должен зависеть от авторизованного интерфейса: CI-задача, серверная функция, сервис на другом языке. Создайте ключ, укажите клиенту Dropstone — и вы вызываете те же три модели, что и в Chat и CLI.

Справочник эндпоинта находится на docs.dropstone.io/cli/api. Эта страница охватывает ключи, биллинг и то, чего ожидать.

Создание API-ключа

  1. Откройте Настройки в вашей панели управления.
  2. В разделе API keys выберите Create key и дайте ему имя.
  3. Скопируйте ключ. Он выглядит как dsk_live_... и показывается только один раз.

Относитесь к ключу как к паролю: никогда не коммитьте его и не отправляйте в браузерном бандле. Любой, кто им владеет, может потратить баланс, стоящий за ним. Вы можете видеть, когда каждый ключ использовался в последний раз, и отозвать любой из них на той же странице.

Биллинг: оплата по мере использования

Запросы по API-ключам тарифицируются по мере использования с вашего кредитного баланса. Лимиты тарифного плана на них не распространяются.

Недельный лимит принадлежит авторизованным поверхностям: Chat, CLI и локальной сессии SDK. API учитывается отдельно, поэтому трафик пайплайна никогда не расходует лимит, в котором вы работаете, а насыщенная неделя в Chat не останавливает пайплайн. Пополните баланс в разделе Billing панели управления.

Ключ с нулевым балансом получает отказ с сообщением об этом и ссылкой на пополнение, а не обслуживается с последующим списанием. Бесплатного тарифа на API нет.

Совместимость с OpenAI

Эндпоинт следует формату chat completions от OpenAI, поэтому большинство существующих клиентов работают после смены базового URL и ключа:

import OpenAI from "openai"

const openai = new OpenAI({
  baseURL: "https://api.dropstone.io/api/v1",
  apiKey: process.env.DROPSTONE_API_KEY,
})

Модели: dropstone-fast, dropstone-pro и dropstone-heavy; см. Выбор модели. Запросы работают из любого языка, способного выполнять HTTP-вызовы.

Что API не поддерживает

Эндпоинт не сохраняет состояние, и это намеренно:

  • Без памяти. Он не читает память вашего аккаунта, и ничего из его ответов там не записывается. Один и тот же ввод даёт один и тот же ответ, независимо от того, чему вы научили Dropstone на прошлой неделе.
  • Без инструментов и без агентского цикла. Он отвечает на chat completion. Чтение кодовой базы, редактирование файлов и выполнение команд относятся к локальному клиенту SDK и CLI.

Если вы хотите, чтобы ваш код использовал агента и его память, используйте локальный клиент SDK. См. Единая память на всех поверхностях.

Лимиты запросов

Запросы ограничены по IP, с запасом выше обычного использования, для защиты сервиса. Всплеск, превышающий лимит, получает отказ, поэтому делайте паузу и повторяйте попытку, а не ужесточайте цикл.

Куда направляются запросы

API-запросы обрабатываются в США, как и все остальные поверхности. См. Где выполняются ваши запросы.

Организации

Участники организации создают ключи под своей учётной записью, и баланс за ключом принадлежит владельцу ключа. Администраторы организации видят использование API по участникам на панели организации, и ключ перестаёт работать, когда учётная запись за ним деактивируется — это происходит при удалении участника через SCIM.

Related articles

Ctrl+I