Corveil Docs

Appearance

curl / direct REST ​

Every Corveil-mediated call ultimately hits POST /v1/chat/completions. If you're integrating from a language without a first-party SDK, hit the endpoint directly.

1. One-shot completion ​

bash
curl https://your-corveil-host/v1/chat/completions \
  -H "Authorization: Bearer sk-citadel-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "or-claude-haiku-4.5",
    "messages": [
      {"role": "user", "content": "Hello from curl"}
    ]
  }'

2. Streaming ​

Add "stream": true to the body and use curl --no-buffer to consume server-sent events:

bash
curl --no-buffer https://your-corveil-host/v1/chat/completions \
  -H "Authorization: Bearer sk-citadel-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"model":"or-claude-haiku-4.5","stream":true,"messages":[{"role":"user","content":"stream please"}]}'

3. List available models ​

bash
curl https://your-corveil-host/v1/models \
  -H "Authorization: Bearer sk-citadel-your-key-here"