Developer Docs & Compatibility

Compatibility

Nodex AI's relay layer is compatible with major model APIs while preserving unified auth, idempotency, and billing metadata.

base_url=https://api.nodex-ai.net/v1
auth=Bearer $NODEX_API_KEY
streaming=SSE
idempotency=required

Authentication & Headers

All API requests must include your API key in an Authorization HTTP header as a Bearer token. Do not store runtime API keys in the browser.

curl https://api.nodex-ai.net/v1/models \
  -H "Authorization: Bearer $NODEX_API_KEY"

OpenAI API Compatibility

Point your OpenAI SDK base URL at Nodex and keep using the chat/completions request shape.

POST https://api.nodex-ai.net/v1/chat/completions
Authorization: Bearer $NODEX_API_KEY

{
  "model": "gpt-5.4",
  "messages": [{"role": "user", "content": "Explain routing."}]
}

Claude API Compatibility

Claude Messages API is translated at the relay boundary while preserving request-level routing and billing metadata.

POST https://api.nodex-ai.net/v1/messages
x-api-key: $NODEX_API_KEY
anthropic-version: 2023-06-01

{
  "model": "claude-sonnet-4.5",
  "max_tokens": 1024,
  "messages": [{"role": "user", "content": "Hello"}]
}

CLI Provider

CLI Provider shares the same account and quota for Codex, Claude Code, and local script workflows.

nodex login
nodex use gpt-5.4
nodex env export

SSE Streaming

SSE streaming responses support interruption recovery through Last-Event-ID.

Last-Event-ID: evt_01HY...
X-Idempotency-Key: req_...

Parameter Mapping