Utiliser l'API Dropstone avec votre plan

L'API Dropstone est un point de terminaison compatible OpenAI pour du code qui ne doit pas dépendre d'une interface connectée : un job CI, une fonction serverless, un service dans un autre langage. Créez une clé, pointez un client vers Dropstone, et vous appelez les trois mêmes modèles que Chat et le CLI.

La référence du point de terminaison se trouve sur docs.dropstone.io/cli/api. Cette page couvre les clés, la facturation et ce à quoi vous attendre.

Créer une clé API

1. 1
   Ouvrez Paramètres dans votre tableau de bord.
2. 2
   Sous Clés API, choisissez Créer une clé et donnez-lui un nom.
3. Copiez la clé. Elle ressemble à dsk_live_... et elle n'est affichée qu'une seule fois.

Traitez la clé comme un mot de passe : ne la committez jamais et ne l'expédiez jamais dans un bundle navigateur. Toute personne qui la détient peut dépenser le solde qui lui est associé. Vous pouvez voir quand chaque clé a été utilisée pour la dernière fois et révoquer n'importe laquelle d'entre elles depuis la même page.

Facturation : paiement à l'usage

L'allocation hebdomadaire appartient aux surfaces connectées : Chat, le CLI et une session SDK locale. L'API est mesurée séparément, donc le trafic d'un pipeline ne consomme jamais l'allocation dans laquelle vous travaillez, et une semaine chargée dans Chat n'arrête jamais le pipeline. Rechargez depuis Facturation dans le tableau de bord.

Une clé dont le solde est vide est refusée avec une erreur l'indiquant et un lien pour recharger, plutôt que d'être servie et facturée plus tard. Il n'y a pas de niveau gratuit sur l'API.

Compatible OpenAI

Le point de terminaison suit le format des complétions de chat OpenAI, donc la plupart des clients existants fonctionnent en changeant l'URL de base et la clé :

import OpenAI from "openai"

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

Les modèles sont dropstone-fast, dropstone-pro et dropstone-heavy ; voir Quels modèles d'IA Dropstone utilise-t-il ?. Nommer un niveau sans version exécute la gamme actuelle, donc un script suit la gamme automatiquement. Pour maintenir une version à la place, utilisez la forme versionnée, par exemple dropstone-fast-1.7. Versions des modèles et gamme mensuelle couvre les deux. Les requêtes fonctionnent depuis n'importe quel langage capable de faire un appel HTTP.

Ce que l'API ne prend pas en charge

Le point de terminaison est sans état, et délibérément :

• Aucune mémoire. Il ne lit pas la mémoire de votre compte, et rien de ce qu'il répond n'y est enregistré. La même entrée donne la même réponse, quoi que vous ayez appris à Dropstone la semaine dernière.
• Aucun outil et aucune boucle d'agent. Il répond à une complétion de chat. Lire une base de code, modifier des fichiers et exécuter des commandes appartiennent au SDK client local et au CLI.

Si vous voulez que votre code utilise l'agent et sa mémoire, utilisez le client local du SDK. Voir Une mémoire sur chaque surface.

Limites de débit

Les requêtes sont limitées en débit par IP, bien au-dessus d'une utilisation ordinaire, pour protéger le service. Une rafale qui déclenche la limite est refusée, donc reculez et réessayez plutôt que de resserrer la boucle.

Où vont les requêtes

Les requêtes API sont traitées aux États-Unis, comme toutes les autres surfaces. Voir Où vos requêtes sont exécutées.

Organisations

Les membres d'une organisation créent des clés sous leur propre compte, et le solde derrière une clé appartient au propriétaire de la clé. Les administrateurs d'organisation peuvent voir l'utilisation de l'API par membre sur le tableau de bord de l'organisation, et une clé cesse de fonctionner lorsque le compte derrière elle est désactivé, ce qui se produit lorsqu'un membre est supprimé via SCIM.