Usa l'API Dropstone con il tuo piano

L'API Dropstone è un endpoint compatibile con OpenAI per codice che non deve dipendere da una superficie con accesso effettuato: un job CI, una funzione serverless, un servizio in un altro linguaggio. Crea una chiave, punta un client verso Dropstone e stai chiamando gli stessi tre modelli di Chat e CLI.

Il riferimento dell'endpoint è su docs.dropstone.io/cli/api. Questa pagina copre chiavi, fatturazione e cosa aspettarsi.

Crea una chiave API

1. 1
   Apri Impostazioni nella tua dashboard.
2. 2
   Sotto Chiavi API, scegli Crea chiave e assegnale un nome.
3. Copia la chiave. Ha questo aspetto dsk_live_... e viene mostrata una sola volta.

Tratta la chiave come una password: non committarla mai e non inviarla mai in un bundle del browser. Chiunque la possieda può spendere il saldo dietro di essa. Puoi vedere quando ogni chiave è stata usata l'ultima volta e revocarne una qualsiasi dalla stessa pagina.

Fatturazione: paghi a consumo

La quota settimanale appartiene alle superfici con accesso effettuato: Chat, CLI e una sessione SDK locale. L'API è misurata separatamente, quindi il traffico di una pipeline non consuma mai la quota in cui lavori, e una settimana intensa in Chat non ferma mai la pipeline. Ricarica da Fatturazione nella dashboard.

Una chiave con saldo vuoto viene rifiutata con un errore che lo dice e un link per ricaricare, invece di essere servita e addebitata in seguito. Non esiste un livello gratuito sull'API.

Compatibile con OpenAI

L'endpoint segue il formato delle chat completions di OpenAI, quindi la maggior parte dei client esistenti funziona cambiando l'URL di base e la chiave:

import OpenAI from "openai"

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

I modelli sono dropstone-fast, dropstone-pro e dropstone-heavy; vedi Quali modelli AI usa Dropstone?. Nominare un livello senza versione esegue la lineup corrente, quindi uno script segue la lineup in avanti da solo. Per mantenere invece una versione, usa la forma con versione, ad esempio dropstone-fast-1.7. Versioni dei modelli e lineup mensile copre entrambe. Le richieste funzionano da qualsiasi linguaggio che possa fare una chiamata HTTP.

Cosa l'API non include

L'endpoint è senza stato, e deliberatamente:

• Nessuna memoria. Non legge la memoria del tuo account, e nulla di ciò che risponde viene registrato lì. Lo stesso input dà la stessa risposta, qualunque cosa tu abbia insegnato a Dropstone la settimana scorsa.
• Nessuno strumento e nessun loop agente. Risponde a una chat completion. Leggere un codebase, modificare file ed eseguire comandi appartengono al client locale SDK e alla CLI.

Se vuoi che il tuo codice usi l'agente e la sua memoria, usa il client locale dell'SDK. Vedi Una memoria su ogni superficie.

Limiti di frequenza

Le richieste sono limitate per frequenza per IP, ben al di sopra dell'uso ordinario, per proteggere il servizio. Un burst che supera il limite viene rifiutato, quindi fai un backoff e riprova invece di stringere il loop.

Dove vanno le richieste

Le richieste API sono elaborate negli Stati Uniti, come ogni altra superficie. Vedi Dove vengono eseguite le tue richieste.

Organizzazioni

I membri di un'organizzazione creano chiavi sotto il proprio account, e il saldo dietro una chiave appartiene al proprietario della chiave. Gli amministratori dell'organizzazione possono vedere l'uso dell'API per membro nella dashboard dell'organizzazione, e una chiave smette di funzionare quando l'account dietro di essa viene disattivato, che è ciò che accade quando un membro viene rimosso tramite SCIM.