モデル一覧

現在のユーザーが利用できるすべての AI モデルの一覧を取得します。モデル ID、名前、プロバイダ、詳細情報が含まれます。

モデル一覧とトークングループについて

一覧に返されるモデルは、API KEY が属するトークングループによって決まります。トークングループは、コンソール → API Tokens でトークンを作成または編集するときに選択できます。

エンドポイント

GET https://aiberm.com/v1/models

リクエスト例

1curl -X GET "https://aiberm.com/v1/models" \
2-H "Authorization: Bearer sk-your-api-token-here" \
3-H "Content-Type: application/json"

レスポンス形式

成功レスポンス（200 OK）

1{
2"success": true,
3"data": [
4  {
5    "id": "gpt-4",
6    "object": "model",
7    "created": 1626777600,
8    "owned_by": "openai",
9    "supported_endpoint_types": [
10      "chat",
11      "completion"
12    ]
13  },
14  {
15    "id": "gpt-3.5-turbo",
16    "object": "model",
17    "created": 1626777600,
18    "owned_by": "openai",
19    "supported_endpoint_types": [
20      "chat",
21      "completion"
22    ]
23  },
24  {
25    "id": "claude-3-sonnet-20240229",
26    "object": "model",
27    "created": 1626777600,
28    "owned_by": "anthropic",
29    "supported_endpoint_types": [
30      "chat"
31    ]
32  }
33]
34}

レスポンスフィールド

トップレベルフィールド:

success - 真偽値。リクエストが成功したかどうかを示します
data - モデルオブジェクトの配列（成功時のみ返されます）
message - エラーメッセージ（失敗時のみ返されます）

モデルオブジェクトのフィールド:

id - モデルの一意な識別子
object - オブジェクトタイプ。固定で “model”
created - モデル作成時のタイムスタンプ
owned_by - モデルプロバイダ（例: openai、anthropic）
supported_endpoint_types - 対応する API エンドポイントタイプの配列

対応エンドポイントタイプ

chat - Chat Completion
completion - Text Completion
embedding - Text Embedding
image - Image Generation
audio - Audio Processing
rerank - Rerank

重要な注意点

認証が必要です

有効な API トークンを指定する必要があります。トークンによって、ユーザーがアクセスできるモデルが決まります。

権限管理

返されるモデル一覧は、ユーザーグループとトークングループに基づいてフィルタされ、ユーザーがアクセス権限を持つモデルだけが表示されます。

よくあるエラー

401 Unauthorized - API トークンが無効、または期限切れです
403 Forbidden - ユーザーにアクセス権限がありません
500 Internal Server Error - 内部サーバーエラーです