# n8n

Pakai sivcloud di n8n lewat kredensial OpenAI atau node HTTP Request.

n8n bisa memanggil sivcloud karena API-nya kompatibel dengan OpenAI. Anda butuh API key dari halaman [API key](https://sivcloud.com/docs/console/api-key/) dan id model dari halaman Model di console.

## Kredensial OpenAI

1. Di n8n, buat kredensial baru bertipe **OpenAI**.
2. Isi **API Key** dengan API key sivcloud Anda.
3. Isi alamat dasar (Base URL) dengan `https://ai.sivcloud.com/v1`. Bila versi n8n Anda tidak menampilkan isian alamat dasar di kredensial, cari isian itu di opsi node; namanya bisa berbeda antarversi.
4. Simpan, lalu jalankan uji koneksi bila ada. Uji koneksi n8n memanggil daftar model; bila gagal tetapi node chat berjalan, abaikan.

## Node OpenAI Chat Model

1. Tambahkan node **OpenAI Chat Model** sebagai sub-node di AI Agent atau Basic LLM Chain.
2. Pilih kredensial sivcloud tadi.
3. Ketik id model dari halaman Model, misalnya `deepseek-v4.1-flash`. Daftar bawaan n8n adalah daftar milik OpenAI, jadi id model sivcloud perlu diketik sendiri.
4. Biarkan pengaturan **Use Responses API** mati supaya n8n memakai chat completions.

Fitur bawaan OpenAI seperti pencarian web dan pencarian berkas milik n8n tidak tersedia lewat sivcloud.

## Cara lain: node HTTP Request

Bila node di atas tidak cocok, kirim request sendiri:

- Metode `POST`, alamat `https://ai.sivcloud.com/v1/chat/completions`.
- Header `Authorization` berisi `Bearer <API key Anda>`, dan `Content-Type` berisi `application/json`.
- Body JSON:

```json
{
  "model": "deepseek-v4.1-flash",
  "messages": [{ "role": "user", "content": "Halo" }]
}
```

Format lengkapnya ada di [halaman endpoint](https://sivcloud.com/docs/chat-completions/).

## Galat umum

- `401`: API key salah, diblokir, atau kedaluwarsa. Periksa kunci di console.
- `402`: saldo habis. Isi saldo di halaman [Saldo](https://sivcloud.com/docs/console/saldo/).
- `404`: id model tidak ada. Salin id persis dari halaman Model.

Daftar lengkap ada di [Kode galat](https://sivcloud.com/docs/galat/). Jangan menaruh API key di alur kerja yang Anda bagikan; simpan di kredensial n8n.