> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Devin Desktop のモデルと料金の一覧取得

> アカウントで利用可能な Devin Desktop のモデルを、モデル UID、名称、および Team に課金されるトークン単位またはメッセージ単位の価格とあわせて一覧表示します。

<div id="overview">
  ## 概要
</div>

呼び出し元のアカウントで利用可能なモデルと、そのアカウントに実際に請求される価格を返します。[モデルページ](/ja/desktop/models)から価格をコピーするのではなく、モデル価格をプログラムから取得する際の基準としてご利用ください。

価格は呼び出し元のプランと課金モデルによって異なるため、同じモデルでもTeamごとに異なる値が返されることがあります。

<Note>このエンドポイントはアルファ版 (`v2alpha`) です。レスポンスの形式は変更される可能性があります。</Note>

<div id="authentication">
  ## 認証
</div>

`Authorization` ヘッダーにAPIキーを指定します。

```
Authorization: Bearer <api-key>
```

Devinの[サービスユーザーAPIキー](/ja/api-reference/authentication) (`cog_...`) を利用します。サービスユーザーのロールに **Use Devin Desktop** 権限が含まれており、かつアカウントでDevin Desktopへのアクセスが有効になっている必要があります。

<div id="request">
  ## Request
</div>

<ParamField query="filter" type="string">
  未設定のままにすると、Team レベルの制限を無視し、プランおよび課金モデルで許可されているすべてのモデルを一覧表示します。

  `allowlist` を指定すると、Team のモデル許可リスト、組織のコントロール、グループの制限も適用され、ユーザーが Devin Desktop のモデルピッカーで目にする内容と同じ一覧になります。
</ParamField>

<div id="example-request">
  ### リクエスト例
</div>

```bash theme={null}
curl https://server.codeium.com/api/v2alpha/models \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

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

```bash theme={null}
curl "https://server.codeium.com/api/v2alpha/models?filter=allowlist" \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

<div id="response">
  ## レスポンス
</div>

<ResponseField name="models" type="object[]">
  呼び出し元が利用できるモデル。無効化されたモデルは含まれません。

  <Expandable title="properties">
    <ResponseField name="uid" type="string">
      安定したモデル識別子。例: `claude-sonnet-4-5`。
    </ResponseField>

    <ResponseField name="name" type="string">
      モデルピッカー に表示される名称。
    </ResponseField>

    <ResponseField name="pricing_dimensions" type="object[]">
      このモデルの利用に対して呼び出し元に課金される価格。課金の発生しないモデルでは空になります。

      <Expandable title="properties">
        <ResponseField name="label" type="string">
          価格の対象を snake\_case で示します。トークン課金の場合は `input`、`output`、`cached_input`、`cache_read`、`cache_write`。通貨以外の単位による価格の場合は課金対象の数量で、メッセージ単位の課金であれば `message` などとなります。Fusion モデルでは、サイドキックの価格も `sidekick_` プレフィックス付きで示されます (例: `sidekick_input`、`sidekick_message`) 。
        </ResponseField>

        <ResponseField name="unit" type="string">
          `value` を表す単位。snake\_case で表記されます。例: `usd`、`acus`、`credits`。
        </ResponseField>

        <ResponseField name="value" type="number">
          `denominator` あたりの価格を `unit` で表した値。
        </ResponseField>

        <ResponseField name="denominator" type="string">
          価格が適用される数量。例: `1M tokens`、`message`。
        </ResponseField>

        <ResponseField name="info" type="string">
          価格に関する任意の注記。例: `Higher effort consumes more tokens`。
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<div id="example-response">
  ### レスポンス例
</div>

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

```json theme={null}
{
  "models": [
    {
      "uid": "claude-sonnet-4-5",
      "name": "Claude Sonnet 4.5",
      "pricing_dimensions": [
        { "label": "input", "unit": "usd", "value": 3, "denominator": "1M tokens" },
        { "label": "cached_input", "unit": "usd", "value": 0.3, "denominator": "1M tokens" },
        { "label": "output", "unit": "usd", "value": 15, "denominator": "1M tokens" }
      ]
    },
    {
      "uid": "example-model",
      "name": "Example Model",
      "pricing_dimensions": [
        { "label": "message", "unit": "acus", "value": 0.5, "denominator": "message" }
      ]
    }
  ]
}
```

<div id="error-responses">
  ## エラーレスポンス
</div>

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

| ステータス | 原因                                                    |
| ----- | ----------------------------------------------------- |
| `400` | `filter` に `allowlist` 以外の値が設定されている                   |
| `401` | APIキーが指定されていない、または無効                                  |
| `403` | キーに紐づくユーザーに Devin Desktop へのアクセス権がない                  |
| `429` | レート制限を超過。再試行する前に `Retry-After` ヘッダーで指定された時間だけ待機してください |