Models API
Annota AI offers the chat models of the Models catalog through the Models API, compatible with OpenAI Chat Completions. Any OpenAI client or SDK works: set the base URL and an API key of your organization.
Base URL
Section titled “Base URL”https://api.annota.ai/openai/v1The API supports:
GET /models: lists the catalog models. It needs no API key.POST /chat/completions: sends a chat request, with or without streaming. It needs an API key.
Use the model ID
shown in the catalog, such as deepseek-v4.1-flash-1017.
Create an API key
Section titled “Create an API key”API keys belong to the organization, not to a member, and spend its credits until they are revoked. Only owners and admins can manage them. Other members can ask an organization owner or admin for a key.
- Go to Settings > API keys and select Create API key.
- Enter a Name that tells where the key is used, such as a project or a server, and select Create API key.
- In Copy your API key, copy the key and store it somewhere safe, then select I saved the key.
The API keys page lists each key with its name, the masked key, who created it, when, and when it was last used. An organization can hold a limited number of keys: revoke one before creating another.
Make a request
Section titled “Make a request”The examples read the key from the ANNOTA_AI_API_KEY environment variable.
Each model page in the app has the same examples in cURL, Python,
TypeScript, Go, and Rust under API.
curl https://api.annota.ai/openai/v1/chat/completions \ -H "Authorization: Bearer $ANNOTA_AI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "deepseek-v4.1-flash-1017", "messages": [{"role": "user", "content": "Hello"}] }'Install the OpenAI Python SDK, then run:
import os
from openai import OpenAI
client = OpenAI( base_url="https://api.annota.ai/openai/v1", api_key=os.environ["ANNOTA_AI_API_KEY"],)
completion = client.chat.completions.create( model="deepseek-v4.1-flash-1017", messages=[{"role": "user", "content": "Hello"}],)print(completion.choices[0].message.content)Credits
Section titled “Credits”Each request is priced exactly at the rates of the model it uses, per million input, cached input, and output tokens, and paid with organization credits. Requests never count toward a member’s weekly Brain usage limit. A request needs a positive credit balance.
- Usage appears as OpenAI-compatible API in the billing usage. See Credit usage.
- If a client disconnects during a streamed response, what the model already generated is still charged.
See Models for the rates.
Revoke a key
Section titled “Revoke a key”- Go to Settings > API keys.
- Select Revoke on the key’s row and confirm.
Requests with the key stop working at once. This cannot be undone. Revoking a key is the way to replace it if it may have leaked.
Next steps
Section titled “Next steps”© 2026 Annota S.r.l.