# Embeddings

POST /v1/embeddings: ubah teks menjadi vektor, ditagih per token input.

`POST https://ai.sivcloud.com/v1/embeddings` memakai format OpenAI Embeddings. SDK OpenAI bekerja tanpa perubahan selain base URL dan API key.

```bash
curl https://ai.sivcloud.com/v1/embeddings \
  -H "Authorization: Bearer $SIVCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/text-embedding-3-small",
    "input": "Halo dunia"
  }'
```

```python
from openai import OpenAI

client = OpenAI(base_url="https://ai.sivcloud.com/v1", api_key="SIVCLOUD_API_KEY")
res = client.embeddings.create(model="openai/text-embedding-3-small", input=["Halo dunia", "Selamat pagi"])
print(len(res.data[0].embedding))
```

## Body

| Field | Arti |
|---|---|
| `model` | Wajib. Id model embedding |
| `input` | Wajib. Satu teks atau daftar teks |
| `encoding_format` | Opsional. `float` atau `base64` |
| `dimensions` | Opsional. Jumlah dimensi, bila model mendukungnya |

Jawaban diteruskan dari penyedia dalam format OpenAI.

## Biaya

Embeddings ditagih per **token input** (`usage.prompt_tokens`) dengan harga input model. Tidak ada token output. Biaya diambil dari saldo, atau dari jatah paket bila jatah itu berlaku untuk model tersebut. Lihat [Langganan](https://sivcloud.com/docs/console/langganan/).

## Model yang tersedia

Model embedding yang bisa Anda pakai adalah yang tampil di halaman Model di console. Model chat tidak bisa dipakai di endpoint ini, dan sebaliknya. Kesalahan dijawab dengan kode di halaman [Galat](https://sivcloud.com/docs/galat/).