Die Dropstone API mit Ihrem Plan nutzen

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 serverlose 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 zu 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 aufbraucht, 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 Fehler abgelehnt, der dies angibt und einen Link zum Aufladen enthält, 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 Welche KI-Modelle verwendet Dropstone?. Wenn Sie eine Stufe ohne Version benennen, wird die aktuelle Modellreihe ausgeführt, sodass ein Skript der Modellreihe von selbst folgt. Um stattdessen eine Version zu halten, verwenden Sie die versionierte Form, zum Beispiel dropstone-fast-1.7. Modellversionen und die monatliche Modellreihe behandelt beides. Anfragen funktionieren aus jeder Sprache, die einen HTTP-Aufruf ausführen kann.

Was die API nicht mit sich führt

Der Endpunkt ist zustandslos, und das ist beabsichtigt:

• Kein Gedächtnis. Er liest nicht Ihr Kontogedächtnis, und nichts, was er antwortet, 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-lokalen Client und zur CLI.

Wenn Sie möchten, dass Ihr Code den Agenten und sein Gedächtnis verwendet, nutzen Sie den lokalen Client des SDKs. Siehe Ein Gedächtnis auf jeder Oberfläche.

Rate Limits

Anfragen werden pro IP ratenbegrenzt, weit über dem normalen Gebrauch, um den Dienst zu schützen. Ein Burst, der das Limit überschreitet, wird abgelehnt. Gehen Sie also zurück und versuchen Sie es erneut, anstatt die Schleife zu straffen.

Wohin Anfragen gehen

API-Anfragen werden in den Vereinigten Staaten verarbeitet, genau wie alle anderen Oberflächen. 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 sehen, und ein Schlüssel funktioniert nicht mehr, wenn das Konto dahinter deaktiviert wird – das passiert, wenn ein Mitglied über SCIM entfernt wird.