プランでDropstone APIを使用する

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

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

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

APIキーを作成する

ダッシュボードで設定を開きます。
APIキーで、キーを作成を選択し、名前を付けます。
キーをコピーします。dsk_live_...のような形式で、一度だけ表示されます。

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

課金：従量課金

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

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

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

OpenAI互換

エンドポイントは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です。DropstoneはどのAIモデルを使用していますか？を参照してください。バージョンなしでティアを指定すると現在のラインナップが実行されるため、スクリプトは自動的にラインナップに追従します。代わりにバージョンを固定するには、dropstone-fast-1.7のようなバージョン付きの形式を使用します。モデルバージョンと月次ラインナップで両方について説明しています。リクエストはHTTP呼び出しができるあらゆる言語から利用できます。

APIが対応しない内容

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

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

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

レート制限

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

リクエストの処理場所

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

組織

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