プランでAPIを使用する

APIキーを使ってDropstoneをHTTP経由で呼び出します。エンドポイントはOpenAI互換で、クレジット残高から従量課金され、あらゆる言語から利用できます。キー、エラー、レート制限、およびAPIが対応しない内容について説明します。

Dropstone APIは、サインインした画面に依存しないコード（CIジョブ、サーバーレス関数、別の言語のサービスなど）向けのOpenAI互換エンドポイントです。キーを作成し、クライアントをDropstoneに向けるだけで、ChatやCLIと同じ3つのモデルを呼び出せます。

エンドポイントのリファレンスはdocs.dropstone.io/cli/apiにあります。このページでは、キー、課金、および期待できる内容について説明します。

APIキーを作成する

キーはパスワードと同じように扱ってください。コミットしたり、ブラウザバンドルに含めたりしないでください。キーを保持している人は誰でも、その背後にある残高を使うことができます。各キーの最終使用日時を確認でき、同じページからいつでも失効させられます。

APIキーのリクエストは、クレジット残高から従量課金されます。プランの利用枠は適用されません。

週次の利用枠はサインインした画面（Chat、CLI、ローカルSDKセッション）に属します。APIは別途メーター制なので、パイプラインのトラフィックが作業用の利用枠を消費することはなく、Chatでの忙しい週がパイプラインを止めることもありません。ダッシュボードの請求からチャージできます。

残高が空のキーは、サービスを提供して後で請求するのではなく、その旨とチャージ用のリンクを含むエラーで拒否されます。APIに無料枠はありません。

エンドポイントはOpenAIのチャット完了形式に従っているため、ほとんどの既存クライアントはベースURLとキーを変更するだけで動作します。

import OpenAI from "openai"

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

モデルはdropstone-fast、dropstone-pro、dropstone-heavyです。モデルを選ぶを参照してください。HTTP呼び出しができるあらゆる言語からリクエストできます。

エンドポイントはステートレスであり、意図的にそう設計されています。

メモリなし。 アカウントのメモリを読み取らず、回答した内容がそこに記録されることもありません。先週Dropstoneに教えた内容に関係なく、同じ入力には同じ回答が返ります。
ツールもエージェントループもなし。 チャット完了に回答するだけです。コードベースの読み取り、ファイルの編集、コマンドの実行は、SDKのローカルクライアントとCLIに属します。

コードでエージェントとそのメモリを使いたい場合は、SDKのローカルクライアントを使用してください。すべての画面で共有されるメモリを参照してください。

リクエストはIPごとにレート制限され、通常の使用量をはるかに上回る上限でサービスを保護しています。制限を超えるバーストは拒否されるため、ループを詰めるのではなく、バックオフして再試行してください。

APIリクエストは、他のすべての画面と同様に米国で処理されます。リクエストの実行場所を参照してください。

組織のメンバーは自分のアカウントでキーを作成し、キーの背後にある残高はキー所有者のものです。組織管理者は組織ダッシュボードでメンバーごとのAPI使用量を確認でき、SCIMを通じてメンバーが削除された場合など、アカウントが無効化されるとキーは動作を停止します。