Skip to main content
すべての Router モデルは {provider}/{model} 形式の ID で指定します。カタログを使ってその ID を見つけ、POST /v2/models/{provider}/{model} を呼び出します。

カタログを検出する

生成に使用したのと同じ APIキーでモデルを一覧表示します:
カタログレスポンスの抜粋:
呼び出しパスには id を使用します。billing オブジェクトには課金に関する事実が含まれており、価格ではありません。これに依存する前に ポリシー拒否時の課金 をお読みください。

ページネーション

  • has_more が true の場合は、返された next_cursor を cursor として渡します。前のページが要求より短かった場合でも、has_more が false になったら停止します。
  • カーソルは不透明な値として扱います。たとえば cURL の --get --data-urlencode "cursor=$NEXT_CURSOR" のように値を URL エンコードしてください。オフセットを計算したりカーソルを変更したりしないでください。
  • limit のデフォルトは 20 で、上限は 100 です。上限を超える値は上限値に丸められます。ゼロおよびネガティブな値はデフォルトを選択します。レスポンスには実際に使用された limit が報告されます。
  • 無効なカーソルは 400 / invalid_input を返します。リストを暗黙的に再起動することはありません。
  • カーソルはカタログの更新をまたいでも有効なままの場合がありますが、走査はスナップショットではありません。現在位置より前に追加されたモデルが、その走査に現れないことがあります。
503 / service_unavailable は一時的なものです。バックオフしながら再試行してください。空のカタログとして扱わないでください。SDK の run メソッドは選択済みのモデルを直接呼び出します。

1 つのモデルを読み取る

モデル ID がわかっている場合は、カタログのエントリを直接取得します:
モデル詳細エンドポイントを使えば、カタログ全体を走査せずに済みます。エントリの完全なフィールドについては API リファレンス を参照してください。

次のステップ

  • スキーマと結果: モデルを呼び出す前に、そのモデルの入力と出力のスキーマを確認します。
  • すべてのモデル: 各モデルで実際に動作するリクエストとともにカタログをブラウズします。