# Katalog Model AI

> Semua model yang bisa dipanggil lewat AI Gateway APIPedia: id untuk field "model", provider, jenis, panjang konteks, dan harga per 1 juta token dalam USD dan coin. Daftar ini diambil langsung dari gateway.

- Halaman: https://apipedia.id/docs/ai-models
- Dokumentasi AI Gateway: https://apipedia.id/docs/ai-gateway.md
- Daftar model live (JSON, tanpa token): `GET https://api.apipedia.id/v1/ai/catalog`

## Endpoint katalog

Endpoint publik, tanpa token, boleh dipanggil dari browser:

```bash
curl "https://api.apipedia.id/v1/ai/catalog"
```

Respons memakai amplop standar APIPedia:

```json
{
  "is_success": true,
  "message": "Katalog model AI",
  "data": {
    "coinPerCredit": 1000,
    "freeDailyRequests": 50,
    "total": 1,
    "models": [
      {
        "id": "openai/gpt-4o-mini",
        "name": "GPT-4o mini",
        "provider": "OpenAI",
        "format": "openai",
        "endpoint": "POST /v1/ai/chat/completions",
        "modality": "text",
        "contextLength": 128000,
        "free": false,
        "pinned": true,
        "pricing": {
          "usd": {
            "inputPer1m": 0.15,
            "outputPer1m": 0.6,
            "perRequest": null
          },
          "coin": {
            "inputPer1m": 150,
            "outputPer1m": 600,
            "perRequest": null
          }
        }
      }
    ]
  }
}
```

Nilai contoh di atas hanya ilustrasi bentuk data; angka dan daftar model yang berlaku selalu dari endpoint.

| Field | Arti |
|---|---|
| `id` | Isi field `model` saat memanggil AI Gateway (public id APIPedia, bukan nama model di provider) |
| `provider` | Pembuat model, mis. OpenAI, Anthropic, Google |
| `format` | `openai` (Chat Completions dan endpoint OpenAI lain) atau `anthropic` (Messages API) |
| `endpoint` | Method dan path yang dipakai, mis. `POST /v1/ai/chat/completions` |
| `modality` | `text`, `image`, `embedding`, `speech`, `transcription`, `rerank`, `video`, `audio` |
| `contextLength` | Panjang konteks dalam token (null bila tidak berlaku) |
| `free` | `true` untuk model dengan kuota harian: tidak memotong kredit, dibatasi `freeDailyRequests` request per hari |
| `pricing.usd` / `pricing.coin` | Harga per 1 juta token input/output, atau per request |

## Harga dan kredit

Model berbayar memotong **kredit AI** sesuai biaya pemakaian di provider: **1 kredit AI = biaya 1 USD di provider = `coinPerCredit` coin**. Kredit dibeli dengan coin di menu **Saldo** [console](https://console.apipedia.id). Harga di katalog sudah dikonversi ke coin per 1 juta token input/output (atau per request untuk model gambar/suara). Model **dengan kuota harian** (`free: true`) tidak memotong kredit, tetapi dibatasi jumlah request per hari per pengguna (`freeDailyRequests`).

## Memakai model

Arahkan SDK OpenAI atau Anthropic ke base URL `https://api.apipedia.id/v1/ai` dengan API key APIPedia, lalu isi `model` dengan `id` dari katalog:

```bash
curl -X POST "https://api.apipedia.id/v1/ai/chat/completions" \
  -H "Authorization: Bearer apk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"<id dari katalog>","messages":[{"role":"user","content":"Halo!"}]}'
```

Contoh yang sama dengan PHP (ekstensi cURL). Respons AI Gateway memakai format OpenAI/Anthropic apa adanya, tanpa amplop `is_success`:

```php
<?php
$ch = curl_init('https://api.apipedia.id/v1/ai/chat/completions');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('APIPEDIA_TOKEN'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'model' => '<id dari katalog>',
        'messages' => [
            [
                'role' => 'user',
                'content' => 'Halo! Perkenalkan dirimu singkat.',
            ],
        ],
    ]),
]);
$res = curl_exec($ch);

$data = json_decode($res, true);
echo $data['choices'][0]['message']['content'], PHP_EOL;
```

Untuk model berformat `anthropic`, panggil `POST https://api.apipedia.id/v1/ai/messages` dengan header `x-api-key` (atau `Authorization: Bearer`). Detail setiap endpoint ada di [dokumentasi AI Gateway](https://apipedia.id/docs/ai-gateway); `GET https://api.apipedia.id/v1/ai/models` mengembalikan daftar yang sama dalam format OpenAI (butuh token).
