# Messages

POST /v1/messages: format Anthropic untuk Claude Code dan klien serupa.

`POST https://ai.sivcloud.com/v1/messages` memakai format Anthropic Messages. Claude Code dan SDK Anthropic memakainya.

```bash
curl https://ai.sivcloud.com/v1/messages \
  -H "x-api-key: $SIVCLOUD_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Halo"}]
  }'
```

Header `Authorization: Bearer` juga diterima.

## Jawaban

```json
{
  "type": "message",
  "role": "assistant",
  "model": "deepseek-v4.1-flash",
  "content": [{"type": "text", "text": "Halo!"}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 20, "output_tokens": 3, "cache_read_input_tokens": 0}
}
```

`cache_read_input_tokens` adalah token input yang terbaca dari cache, dan `cache_creation_input_tokens` adalah token yang ditulis ke cache. Lihat [Cache](https://sivcloud.com/docs/cache/).

## Menghitung token

`POST https://ai.sivcloud.com/v1/messages/count_tokens` menghitung token input sebuah permintaan Messages tanpa membuat pesan. Isi permintaannya sama dengan `/v1/messages`; `system`, `messages`, dan `tools` ikut dihitung.

```bash
curl https://ai.sivcloud.com/v1/messages/count_tokens \
  -H "x-api-key: $SIVCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-v4.1-flash", "messages": [{"role": "user", "content": "Hello"}]}'
```

```json
{"input_tokens": 9}
```

Angkanya perkiraan lokal dan bisa sedikit berbeda dari `usage` pada respons. Permintaan ini gratis, tidak memotong saldo atau jatah, dan tidak muncul di log pemakaian. Kunci API tetap wajib.

## Yang perlu diketahui

- `max_tokens` wajib, seperti pada API Anthropic. Cadangan biaya dihitung darinya.
- Tidak semua model membuka endpoint ini. Halaman Model di console menandai endpoint tiap model.
- Streaming memakai `"stream": true`. Lihat [Streaming](https://sivcloud.com/docs/streaming/).
- Pemasangan Claude Code ada di [Claude Code](https://sivcloud.com/docs/alat/claude-code/).