Dropstone Support

Utiliser l'API avec votre plan

Appelez Dropstone via HTTP avec une clé API. L'endpoint est compatible OpenAI, facturé à l'usage depuis votre solde de crédits, et fonctionne depuis n'importe quel langage. Clés, erreurs, limites de débit et ce que l'API ne prend pas en charge.

L'API Dropstone est un endpoint 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 la CLI.

La référence de l'endpoint 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. Ouvrez Paramètres dans votre tableau de bord.
  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 commitez 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

Les requêtes avec clé API sont facturées à l'usage depuis votre solde de crédits. Les allocations du plan ne s'y appliquent pas.

L'allocation hebdomadaire appartient aux surfaces connectées : Chat, la 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 d'offre gratuite sur l'API.

Compatible OpenAI

L'endpoint 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 Choisir un modèle. Les requêtes fonctionnent depuis n'importe quel langage capable d'effectuer un appel HTTP.

Ce que l'API ne prend pas en charge

L'endpoint est sans état, et ce, 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 client local SDK et à la 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'un usage 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 qui la porte est désactivé, ce qui se produit lorsqu'un membre est supprimé via SCIM.

Related articles

Ctrl+I