Dropstone Support

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

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

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

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

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

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

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

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

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

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

Ключ с пустым балансом получает отказ с сообщением об этом и ссылкой на пополнение, а не обслуживается с последующей оплатой. Бесплатного тарифа на 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; см. Какие AI-модели использует Dropstone?. Указание уровня без версии запускает текущий состав моделей, поэтому скрипт автоматически следует за обновлениями состава. Чтобы зафиксировать версию, используйте форму с версией, например dropstone-fast-1.7. Версии моделей и ежемесячный состав описывает оба варианта. Запросы работают из любого языка, способного выполнять HTTP-вызовы.

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

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

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

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

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

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

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

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

Организации

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

Related articles

Ctrl+I