Usando a API com seu plano

A API do Dropstone é um endpoint compatível com OpenAI para código que não deve depender de uma superfície com login: um job de CI, uma função serverless, um serviço em outra linguagem. Crie uma chave, aponte um cliente para o Dropstone, e você estará chamando os mesmos três modelos do Chat e da CLI.

A referência do endpoint está em docs.dropstone.io/cli/api. Esta página cobre chaves, cobrança e o que esperar.

Criar uma chave de API

1. 1
   Abra Configurações no seu dashboard.
2. 2
   Em Chaves de API, escolha Criar chave e dê um nome a ela.
3. Copie a chave. Ela parece com dsk_live_... e é mostrada apenas uma vez.

Trate a chave como uma senha: nunca a envie para um repositório e nunca a inclua em um bundle de navegador. Qualquer pessoa que a possua pode gastar o saldo por trás dela. Você pode ver quando cada chave foi usada pela última vez e revogar qualquer uma delas na mesma página.

Cobrança: pague por uso

A franquia semanal pertence às superfícies com login: Chat, CLI e uma sessão local do SDK. A API é medida separadamente, então o tráfego de um pipeline nunca consome a franquia em que você trabalha, e uma semana movimentada no Chat nunca interrompe o pipeline. Recarregue em Cobrança no dashboard.

Uma chave com saldo vazio é recusada com um erro informando isso e um link para recarregar, em vez de ser atendida e cobrada depois. Não há camada gratuita na API.

Compatível com OpenAI

O endpoint segue o formato de chat completions da OpenAI, então a maioria dos clientes existentes funciona apenas alterando a URL base e a chave:

import OpenAI from "openai"

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

Os modelos são dropstone-fast, dropstone-pro e dropstone-heavy; veja Escolher um modelo. As requisições funcionam em qualquer linguagem que possa fazer uma chamada HTTP.

O que a API não carrega

O endpoint é stateless, e deliberadamente assim:

• Sem memória. Ele não lê a memória da sua conta, e nada que ele responde é registrado nela. A mesma entrada dá a mesma resposta, não importa o que você ensinou ao Dropstone na semana passada.
• Sem ferramentas e sem loop de agente. Ele responde a um chat completion. Ler um codebase, editar arquivos e executar comandos pertencem ao SDK cliente local e à CLI.

Se você quiser que seu código use o agente e sua memória, use o cliente local do SDK. Veja Uma memória em todas as superfícies.

Limites de taxa

As requisições são limitadas por IP, bem acima do uso comum, para proteger o serviço. Uma rajada que ultrapasse o limite é recusada, então recue e tente novamente em vez de apertar o loop.

Para onde as requisições vão

As requisições de API são processadas nos Estados Unidos, assim como todas as outras superfícies. Veja Onde suas requisições são executadas.

Organizações

Membros de uma organização criam chaves sob sua própria conta, e o saldo por trás de uma chave é do proprietário da chave. Os administradores da organização podem ver o uso da API por membro no dashboard da organização, e uma chave para de funcionar quando a conta por trás dela é desativada, o que acontece quando um membro é removido via SCIM.