Use a API Dropstone com seu plano

A API 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 a 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 API keys, escolha Criar chave e dê um nome a ela.
3. Copie a chave. Ela se 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. Adicione créditos em Cobrança no dashboard.

Uma chave cujo saldo está vazio é recusada com um erro informando isso e um link para adicionar créditos, 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 Quais modelos de IA a Dropstone usa?. Nomear um nível sem versão executa a linha atual, então um script acompanha a linha automaticamente. Para fixar uma versão, use a forma versionada, por exemplo dropstone-fast-1.7. Versões de modelos e a linha mensal cobre ambos. As requisições funcionam em qualquer linguagem que possa fazer uma chamada HTTP.

O que a API não carrega

O endpoint é sem estado, e deliberadamente assim:

• Sem memória. Ele não lê a memória da sua conta, e nada que ele responde é registrado lá. A mesma entrada dá a mesma resposta, independentemente do que você ensinou à Dropstone na semana passada.
• Sem ferramentas e sem loop de agente. Ele responde a uma chat completion. Ler um código, 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 exceda 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, o mesmo que 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 dono da chave. Administradores de 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.