メインコンテンツへスキップ
GET
Devin Desktop のモデルと料金の一覧取得

概要

呼び出し元のアカウントで利用可能なモデル、そのアカウントに実際に請求される価格、各モデルが現在あなたのTeamで許可されているかどうか、およびTeamに保存されているモデルの許可リストを返します。モデルページから価格をコピーするのではなく、モデル価格をプログラムから取得する際の基準として、また Update Model Allowlist API と対になる読み取り用 API としてご利用ください。 価格は呼び出し元のプランと課金モデルによって異なるため、同じモデルでもTeamごとに異なる値が返されることがあります。
このエンドポイントはアルファ版 (v2alpha) です。レスポンスの形式は変更される可能性があります。

認証

Authorization ヘッダーにAPIキーを指定します。
DevinのサービスユーザーAPIキー (cog_...) を利用します。サービスユーザーのロールに Use Devin Desktop 権限が含まれており、かつアカウントでDevin Desktopへのアクセスが有効になっている必要があります。

Request

string
未設定のままにすると、Team レベルの制限を無視し、プランおよび課金モデルで許可されているすべてのモデルを一覧表示します。各モデルの allowed フィールドで、そのモデルが Team の制限によって現在許可されているかどうかを確認できます。allowlist を指定すると、Team のモデル許可リスト、組織のコントロール、グループの制限によって許可されたモデルのみが一覧表示され、ユーザーが Devin Desktop のモデルピッカーで目にする内容と同じ一覧になります。
string
以前のレスポンスで取得した ETag。それ以降レスポンスに変更がない場合は、ボディなしで 304 Not Modified を返します。

リクエスト例

ユーザーが選択できるモデルのみ:

レスポンス

レスポンスには ETag ヘッダーが含まれます。この値は、フィルター適用前のレスポンス内容 (利用可能なモデル、その名称と料金、allowed フラグ、許可リストのフィールド) のいずれかが変更されるたびに変わります。この値を If-Match として Update Model Allowlist API に渡してください。値は filter の指定にかかわらず同じです。
object[]
呼び出し元が利用できるモデル。無効化されたモデルは含まれません。
string[]
Teamの許可リストに保存されているとおりのモデル UID。Teamがタグのみでモデルを許可している場合は空になります。
string[]
Teamの許可リストに保存されているとおりのモデルタグ。provider-anthropic などのプロバイダータグも含まれます。UID がリストに含まれているモデル、またはリスト内のタグが付いているモデルが許可されます。

レスポンス例

以下のモデルと価格はレスポンスの構造を示すための例です。実際の価格はエンドポイントを呼び出して確認してください。

エラーレスポンス

エラーは {"error": "<message>"} の形式で返されます。