モデル

GET /v1/models

モデルを価格とメタデータとともに一覧表示します。

認証は任意です。API キーを付けると、組織が利用権限を持つモデルだけが組織の請求通貨の価格で一覧に含まれます。付けない場合は、ai& が提供するすべてのモデルが USD の価格で一覧に含まれます。キーなしのリクエストは IP ごとに毎分 600 回までに制限されます。この上限は GET /v1/videos/models を含む、キーなしで呼べるすべてのカタログエンドポイントで共有されます。

使用例

curl https://api.aiand.com/v1/models

API キーを使う場合:

curl https://api.aiand.com/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

レスポンス

{
  "object": "list",
  "data": [
    {
      "id": "google/gemma-4-31b-it",
      "name": "google/gemma-4-31b-it",
      "object": "model",
      "created": 1775474514,
      "owned_by": "ai&",
      "provider": "google",
      "context_window": 262144,
      "max_output_tokens": 32768,
      "capabilities": [
        "reasoning",
        "tool_calling",
        "vision",
        "video",
        "document"
      ],
      "reasoning_efforts": [
        "none",
        "high"
      ],
      "reasoning_effort_default": "none",
      "description": "Largest Gemma 4 instruction model for open, self-hosted chat and reasoning",
      "currency": "usd",
      "input_per_1m": "0.200000",
      "output_per_1m": "0.500000",
      "cached_input_per_1m": "0.050000",
      "deprecation_date": null
    }
  ]
}

モデルオブジェクト

フィールド	型	説明
`id`	string	モデル識別子 — リクエストの `model` パラメータにこの値を指定します
`object`	string	常に `"model"`
`created`	integer	Unix タイムスタンプ
`owned_by`	string	常に `"ai&"`
`provider`	string	上流プロバイダ名
`context_window`	integer	最大コンテキスト長 (トークン数)
`max_output_tokens`	integer \| null	記録済みの最大生成トークン数。上限が記録されていないときは `null`
`description`	string	モデルの簡単な説明
`currency`	string	組織の請求通貨（`usd` または `jpy`）
`input_per_1m`	string	入力 100 万トークンあたりのコスト（請求通貨建て）。精度保持のため数値を文字列で返します（例: `"0.150000"`）
`output_per_1m`	string	出力 100 万トークンあたりのコスト（請求通貨建て）
`deprecation_date`	string \| null	モデルがリクエストの受付を終了する日時 (ISO 8601)。終了予定がないときは `null`

使用例

curl https://api.aiand.com/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

モデル名の解決

推論リクエスト (/v1/chat/completions、/v1/responses、/v1/messages) で指定する model パラメータは、GET /v1/models のモデル id と完全に一致している必要があります。大文字と小文字は区別しませんが、部分的な名前は受け付けません。バージョンを省略したモデルファミリー名を指定すると、バージョンを推測せずに 404 (エラーコード model_not_found) を返します。有効な名前は GET /v1/models で確認してください。

モデルは存在するものの組織に利用権限がない場合は、404 (エラーコード model_access_denied) を返します。このモデルは組織の GET /v1/models の一覧にも含まれません。

使用量は、送信した大文字・小文字の表記にかかわらず、常にモデルの正規の id で記録・課金されます。

コストの計算

cost = (input_tokens / 1_000_000 * input_per_1m) + (output_tokens / 1_000_000 * output_per_1m)

クレジットはリクエストが成功するたびに差し引かれます。失敗したリクエスト (4xx / 5xx) は課金されません。