# モデル

Source: https://aiand-docs-staging.pages.dev/ja/api/models/

```http
GET /v1/models
```

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

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

## 使用例

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

API キーを使う場合:

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

## レスポンス

```json
{
  "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` |

## 使用例

```bash
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) は課金されません。