メインコンテンツへスキップ
GET /api/v1/cloud/models 現在のアカウントで有効なモデルを一覧表示します。Agent の作成または更新時に model の値を選択するためにこのエンドポイントを使用してください。

​
ヘッダー

ヘッダー必須説明
AuthorizationはいBearer $QODER_PAT

​
クエリパラメータ

このエンドポイントは現在クエリパラメータを受け付けません。

​
リクエスト例

curl -X GET "https://api.qoder.com/api/v1/cloud/models" \
  -H "Authorization: Bearer $QODER_PAT"

​
レスポンス例

HTTP 200 OK 
{
  "data": [
    {
      "id": "ultimate",
      "type": "model",
      "display_name": "Ultimate",
      "source": "system",
      "is_enabled": true,
      "is_new": false,
      "price_factor": 1.6,
      "efforts": ["low", "medium", "high", "xhigh", "max"],
      "default_effort": "high",
      "max_input_tokens": 1000000,
      "default_context_window": 200000,
      "available_context_windows": [200000, 400000, 1000000]
    }
  ],
  "has_more": false
}

​
レスポンスフィールド

フィールド型説明
dataarray利用可能なモデルオブジェクト
has_moreboolean常に false。モデルリストはページネーションされません
各モデルオブジェクトには以下が含まれます:
フィールド型説明
idstringAgent の model として渡すモデル識別子
typestring固定値 "model"
display_namestring人間が読めるモデル名
sourcestringモデルソース、通常は system。アカウント固有のモデルの場合は user
is_enabledbooleanモデルが有効で使用可能かどうか
is_newbooleanモデルが新規としてマークされているかどうか
price_factornumber任意の相対価格倍率
effortsarray任意のサポートされる推論エフォートレベル。none、low、medium、high、xhigh、max など
default_effortstring上流カタログで指定されている場合の任意のデフォルトエフォートレベル
max_input_tokensintegerモデルがサポートする最大入力コンテキスト(トークン数)
default_context_windowinteger任意。Agent が設定しない場合に使用するデフォルトのコンテキストウィンドウ(トークン数)
available_context_windowsarray of integer任意。Agent の作成/更新時に model.context_window として受け付ける、ユーザー選択可能なコンテキストウィンドウの階層(トークン数)

​
注意事項

  • 有効なモデルのみが返却されます。
  • レスポンスには内部ルーティング、プロバイダー、シークレット、description フィールドは含まれません。
  • モデルカタログは認証されたユーザーとサービスの設定シーンに基づいて解決されます。デフォルトのシーンは assistant です。

​
エラー

HTTPタイプトリガー条件
401authentication_errorPAT が無効または期限切れ
503api_errorモデルカタログが一時的に利用不可
エラーエンベロープの詳細についてはエラーリファレンスを参照してください。

​
関連項目

Agent の定義

再利用可能でバージョン管理された Agent 構成を作成します。