Docs

Quickstart

Create an API key and send your first request.

1. Create an account and add credit

Sign up at the console. Billing is prepaid: top up your balance in the console, and requests draw from it. When the balance reaches zero, requests fail with 402 insufficient_credits until you top up again.

2. Create an API key

In the console, open the API keys area and create a key. Copy the key right away. It starts with io-sk- and is shown only once.

Store it in an environment variable rather than in your code:

export INTERODIN_API_KEY="io-sk-your-key"

3. Send your first request

This calls Chat Completions, the most widely supported format. The model is odin-v1.

The curl sample is written for bash. On Windows, use Git Bash or WSL, or run curl.exe from PowerShell and read the key with $env:INTERODIN_API_KEY instead of $INTERODIN_API_KEY.

curl https://api.interodin.com/v1/chat/completions \
  -H "Authorization: Bearer $INTERODIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "odin-v1",
    "messages": [{"role": "user", "content": "Say hello in Romanian."}]
  }'

The reply is a standard Chat Completions object. The answer is in choices[0].message.content (the curl and Java samples print the whole JSON object), and usage tells you how many tokens you were billed for.

4. Next steps

On this page