Dropstone Support

Utilizzare l'API con il tuo piano

Chiama Dropstone via HTTP con una chiave API. L'endpoint è compatibile con OpenAI, fatturato a consumo dal tuo saldo crediti, e funziona da qualsiasi linguaggio. Chiavi, errori, limiti di frequenza e cosa l'API non include.

L'API di Dropstone è un endpoint compatibile con OpenAI per codice che non deve dipendere da un'interfaccia con accesso: 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. Apri Impostazioni nella tua dashboard.
  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 includerla mai in un bundle per browser. Chiunque la possieda può spendere il saldo ad essa associato. Puoi vedere quando ogni chiave è stata usata l'ultima volta e revocarne una qualsiasi dalla stessa pagina.

Fatturazione: paghi a consumo

Le richieste con chiave API sono fatturate a consumo dal tuo saldo crediti. Le quote del piano non si applicano ad esse.

La quota settimanale appartiene alle superfici con accesso: 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 dalla sezione Fatturazione nella dashboard.

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

Compatibile con OpenAI

L'endpoint segue il formato 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; consulta Scegli un modello. Le richieste funzionano da qualsiasi linguaggio in grado di effettuare una chiamata HTTP.

Cosa l'API non include

L'endpoint è stateless, 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.
  • Nessun tool 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. Consulta Una memoria su ogni superficie.

Limiti di frequenza

Le richieste sono limitate per IP, ben al di sopra dell'uso ordinario, per proteggere il servizio. Un picco che supera il limite viene rifiutato, quindi attendi e riprova invece di stringere il ciclo.

Dove vanno le richieste

Le richieste API vengono elaborate negli Stati Uniti, come ogni altra superficie. Consulta 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'utilizzo API per membro nella dashboard dell'organizzazione, e una chiave smette di funzionare quando l'account dietro di essa viene disattivato, cosa che accade quando un membro viene rimosso tramite SCIM.

Related articles

Ctrl+I