docs
SDKs and frameworks

OpenAI SDK (Node.js)

Markdown

SDK · OpenAI Chat, OpenAI Responses

Full guide
FormatWhere to set it up
OpenAI Chat, OpenAI ResponsesConstructor option new OpenAI({ baseURL, apiKey }); the SDK reads OPENAI_BASE_URL by default

Setup

Copy the configuration and replace sk-... with your key from the Ailoot Dashboard. Prefer storing the key in the environment variable AILOOT_API_KEY, if the application supports it.

Before starting, request GET /v1/models with your Ailoot key. Choose an exact model ID whose methods include POST /v1/chat/completions, POST /v1/responses, then use that ID in the configuration. For agents, also check tool support and the features required by your client version.

import OpenAI from "openai";
const client = new OpenAI({maxRetries: 0,
  baseURL: "https://api.ailoot.ai/v1",
  apiKey: process.env.AILOOT_API_KEY // sk-...
});
const r = await client.chat.completions.create({
  model: "claude-sonnet-5-5",
  messages: [{ role: "user", content: "Hello" }]
});
console.log(r.choices[0].message.content);

This configuration reads the key from the environment variable AILOOT_API_KEY. Set it before starting the application:

export AILOOT_API_KEY="sk-..."   # add to ~/.zshrc or ~/.bashrc

Example model: claude-sonnet-5-5, gpt-6.1-sol, grok-4.7. Choose any other model from the catalog — check that it supports the format you need.

Good to know

Test

  • For the OpenAI format, the URL is https://api.ailoot.ai/v1 (or the full path if the application asks for a full URL).
  • Ask a short question. If you get an error, check the code and Request ID, then consult Errors and limits.
  • 404 immediately after setup almost always means the URL is wrong: an extra or missing /v1.
  • 402 — insufficient balance for the reserve. Agents reserve more than chat: why.

Application documentation: https://github.com/openai/openai-node

Still have questions? Send your Request ID and a description — we'll help you troubleshoot.Contact support