# Quick start

From a new account to your first request in a few minutes.

sivcloud is an OpenAI-compatible LLM API. The base URL is:

```text
https://ai.sivcloud.com/v1
```

## Steps

1. Create an account in the console and open the verification link sent to your email. You can also sign in with Google.
2. Add balance with QRIS. Each payment is between Rp 15,000 and Rp 10,000,000. The [Balance](https://sivcloud.com/en/docs/console/balance/) page explains how.
3. Create an API key on the API keys page. Copy it and keep it in the environment variable `SIVCLOUD_API_KEY`.
4. Send a request. Change the base URL in the SDK you already use, or copy an example below.

## Examples

```bash
curl https://ai.sivcloud.com/v1/chat/completions \
  -H "Authorization: Bearer $SIVCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "deepseek-v4.1-flash",
  "messages": [
    {
      "role": "user",
      "content": "Halo"
    }
  ]
}'
```

```python
import os
from openai import OpenAI

client = OpenAI(base_url="https://ai.sivcloud.com/v1", api_key=os.environ["SIVCLOUD_API_KEY"])
reply = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[
        {"role": "user", "content": "Halo"},
    ],
)
print(reply.choices[0].message.content)
```

```javascript
import OpenAI from 'openai'

const client = new OpenAI({ baseURL: 'https://ai.sivcloud.com/v1', apiKey: process.env.SIVCLOUD_API_KEY })
const reply = await client.chat.completions.create({
  model: "deepseek-v4.1-flash",
  messages: [
    {"role": "user", "content": "Halo"},
  ],
})
console.log(reply.choices[0].message.content)
```

The model in the examples is `deepseek-v4.1-flash`. The list of models and their prices is on the Models page in the console, and also at `GET https://ai.sivcloud.com/v1/models`.

## Endpoints

| Endpoint | Used for |
|---|---|
| `POST /v1/chat/completions` | OpenAI SDKs, most coding tools |
| `POST /v1/messages` | Claude Code and Anthropic-format clients |
| `POST /v1/responses` | Codex CLI and Responses-format clients |
| `GET /v1/models` | List of models |

Other endpoints are closed and answer `unsupported_endpoint`. See [Error codes](https://sivcloud.com/en/docs/errors/).

## Next

- [Authentication](https://sivcloud.com/en/docs/authentication/): how to send the API key.
- [Cache](https://sivcloud.com/en/docs/cache/): tokens read from cache cost much less.
- [Coding tools](https://sivcloud.com/en/docs/tools/claude-code/): set up Claude Code, Codex CLI and others.