FAQ
Answers to common Nodal product and API questions.
Is The API OpenAI Compatible?
Yes for the core gateway routes: chat completions, embeddings, and model listing. Nodal adds workspace billing, model aliases, provider routing, and Nodal-specific error codes around that shape.
Do API Keys Belong To Users Or Workspaces?
API keys belong to workspaces. A key bills and logs usage against the workspace where it was created.
Can I Use Existing OpenAI SDKs?
Usually yes. Configure the SDK base URL to point at Nodal and use a Nodal API key. Use model aliases such as Fast, Smart, or the aliases configured in your catalog.
Why Did A Request Fail Before Provider Dispatch?
Common reasons include invalid key, insufficient funds, spending limit exceeded, workspace suspension, model disabled, model not priced, unsupported vision input, or rate limiting.
Does Nodal Execute Tool Calls?
No. Nodal forwards tool definitions and returns model tool calls. Your application executes functions and sends tool results back.
Is There A Plugin Marketplace?
No public plugin marketplace is implemented today. See Plugins for the current boundary.
Where Do I Find Schemas?
Use the API Reference or raw /api/openapi.json.