Quickstart

Get an API key

Create an account at tomoul.ai/signup. New accounts get $5 in free credits — enough to embed a few million tokens or run a few thousand chat completions. No card required.

Once you're in the console: Settings → API keys → New key. Copy the key once — Tomoul only shows it the one time.

Export your key

export TOMOUL_KEY="tomoul_sk_..."

Make a request

curl https://api.tomoul.ai/v1/embeddings \
-H "Authorization: Bearer $TOMOUL_KEY" \
-H "Content-Type: application/json" \
-d '{
  "model": "baai/bge-m3",
  "input": "Habari za asubuhi."
}'

You should see a JSON response with an embedding array of 1024 floats. That's it — you've used Tomoul.

Where next

• Migrating from OpenAI? 3-minute migration guide →
• Building RAG? bge-m3 + reranker walkthrough →
• Running locally? tomoul serve →
• Looking for a chat model? Chat completions reference →