モデル一覧の取得

GET /v1/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"],
      "default_effort": "medium"
    }
  ],
  "has_more": false
}

レスポンスフィールド

フィールド	型	説明
`data`	array	利用可能なモデルオブジェクト
`has_more`	boolean	常に `false`。モデルリストはページネーションされません

各モデルオブジェクトには以下が含まれます:

フィールド	型	説明
`id`	string	Agent の `model` として渡すモデル識別子
`type`	string	固定値 `"model"`
`display_name`	string	人間が読めるモデル名
`source`	string	モデルソース、通常は `system`。アカウント固有のモデルの場合は `user`
`is_enabled`	boolean	モデルが有効で使用可能かどうか
`is_new`	boolean	モデルが新規としてマークされているかどうか
`price_factor`	number	任意の相対価格倍率
`efforts`	array	任意のサポートされる推論エフォートレベル。`none`、`low`、`medium`、`high`、`xhigh`、`max` など
`default_effort`	string	上流カタログで指定されている場合の任意のデフォルトエフォートレベル

注意事項

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

エラー

HTTP	タイプ	トリガー条件
401	`authentication_error`	PAT が無効または期限切れ
503	`api_error`	モデルカタログが一時的に利用不可

エラーエンベロープの詳細についてはエラーリファレンスを参照してください。

Agent の定義

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

​ヘッダー

​クエリパラメータ

​リクエスト例

​レスポンス例

​レスポンスフィールド

​注意事項

​エラー

​関連項目