Back to home

API access

Call your AIs from your own apps and workflows with an API key. API access is on Pro and up.

Create a key

Open the avatar menu (top right), go to Account, then API access, and create a key.

  • The full key is shown once. Copy it and keep it somewhere safe.
  • Keys carry your account's access. Use them server-side and never expose them in a browser.
  • You can revoke a key at any time.

List your AIs

Send a GET request to /api/v1/models. It returns your AIs and their ids, which you will need when you start a chat.

Chat

Send a POST request to /api/v1/chat with a JSON body. This uses the same engine and knowledge as the in-app chat.

  • model: the id of the AI you want to use.
  • messages: the conversation so far, as a list of role and content pairs.
  • Optional: stream, temperature, and max_tokens.
  • Set stream to true for a streamed NDJSON response.

Example request

The base URL below is your API base. Replace the key and model id with your own.

curl https://api.noetava.com/api/v1/chat \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"model":"your-ai-id","messages":[{"role":"user","content":"Hello"}]}'

Next: Billing & plans