Verwenden der API mit Ihrem Plan

Die Dropstone API ist ein OpenAI-kompatibler Endpunkt für Code, der nicht von einer angemeldeten Oberfläche abhängen soll: ein CI-Job, eine Serverless-Funktion, ein Dienst in einer anderen Sprache. Erstellen Sie einen Schlüssel, richten Sie einen Client auf Dropstone aus, und Sie rufen dieselben drei Modelle auf wie Chat und die CLI.

Die Endpunkt-Referenz finden Sie unter docs.dropstone.io/cli/api. Diese Seite behandelt Schlüssel, Abrechnung und was Sie erwarten können.

Einen API-Schlüssel erstellen

1. 1
   Öffnen Sie Einstellungen in Ihrem Dashboard.
2. 2
   Wählen Sie unter API-Schlüssel die Option Schlüssel erstellen und geben Sie ihm einen Namen.
3. Kopieren Sie den Schlüssel. Er sieht aus wie dsk_live_... und wird nur einmal angezeigt.

Behandeln Sie den Schlüssel wie ein Passwort: Committen Sie ihn niemals und liefern Sie ihn niemals in einem Browser-Bundle aus. Jeder, der ihn besitzt, kann das dahinterliegende Guthaben ausgeben. Sie können auf derselben Seite sehen, wann jeder Schlüssel zuletzt verwendet wurde, und jeden davon widerrufen.

Abrechnung: nutzungsbasiert

Das wöchentliche Kontingent gehört den angemeldeten Oberflächen: Chat, der CLI und einer lokalen SDK-Sitzung. Die API wird separat gemessen, sodass der Datenverkehr einer Pipeline niemals das Kontingent verbraucht, in dem Sie arbeiten, und eine arbeitsreiche Woche in Chat die Pipeline niemals stoppt. Laden Sie unter Abrechnung im Dashboard Guthaben auf.

Ein Schlüssel mit leerem Guthaben wird mit einem entsprechenden Fehler und einem Link zum Aufladen abgelehnt, anstatt bedient und später abgerechnet zu werden. Es gibt keinen kostenlosen Tarif für die API.

OpenAI-kompatibel

Der Endpunkt folgt dem OpenAI-Chat-Completions-Format, sodass die meisten vorhandenen Clients funktionieren, indem Sie die Basis-URL und den Schlüssel ändern:

import OpenAI from "openai"

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

Die Modelle sind dropstone-fast, dropstone-pro und dropstone-heavy; siehe Modell wählen. Anfragen funktionieren aus jeder Sprache, die einen HTTP-Aufruf durchführen kann.

Was die API nicht übernimmt

Der Endpunkt ist zustandslos, und das ist beabsichtigt:

• Kein Gedächtnis. Er liest nicht Ihr Konto-Gedächtnis, und nichts, was er beantwortet, wird dort gespeichert. Dieselbe Eingabe ergibt dieselbe Antwort, egal was Sie Dropstone letzte Woche beigebracht haben.
• Keine Tools und keine Agent-Schleife. Er beantwortet eine Chat-Completion. Das Lesen einer Codebasis, das Bearbeiten von Dateien und das Ausführen von Befehlen gehören zum SDK-Lokalclient und zur CLI.

Wenn Sie möchten, dass Ihr Code den Agenten und sein Gedächtnis nutzt, verwenden Sie den Lokalclient des SDK. Siehe Ein Gedächtnis auf jeder Oberfläche.

Rate-Limits

Anfragen werden pro IP ratenbegrenzt, deutlich über der normalen Nutzung, um den Dienst zu schützen. Ein Burst, der das Limit auslöst, wird abgelehnt. Gehen Sie also zurück und versuchen Sie es erneut, anstatt die Schleife zu verkürzen.

Wohin Anfragen gehen

API-Anfragen werden in den Vereinigten Staaten verarbeitet, genau wie jede andere Oberfläche. Siehe Wo Ihre Anfragen ausgeführt werden.

Organisationen

Mitglieder einer Organisation erstellen Schlüssel unter ihrem eigenen Konto, und das Guthaben hinter einem Schlüssel gehört dem Schlüsselinhaber. Organisationsadministratoren können die API-Nutzung pro Mitglied im Organisations-Dashboard einsehen, und ein Schlüssel funktioniert nicht mehr, wenn das dahinterliegende Konto deaktiviert wird – das passiert, wenn ein Mitglied über SCIM entfernt wird.