Responses

The /v1/responses endpoint supports the OpenAI Responses API format for autonomous agent loops, multi-step tool execution, and complex reasoning pipelines. Route requests across provider clouds with configurable fallback chains, safety guardrails, and exact provider list pricing with zero markup.

• Architectural Lifecycle: Preflight validates key ACLs, checks rate limits (RPM/TPM), inspects content, and reserves token credit. Blocked requests return HTTP 400 (x-nr-guardrails: blocked) with $0 spent and $0 held.
• Failover & Settlement: Failovers occur only where a fallback chain is configured (in Router Settings or nrouter_fallbacks), and spend settles atomically at end-of-response.

POST https://api.nrouter.ai/v1/responses

Request Parameters

Examples

import { nRouter } from "@nrouter_ai/sdk";
const client = new nRouter({ apiKey: process.env.NROUTER_API_KEY });
const res = await client.responses.create({
  model: "gpt-5.4-mini",
  input: "Summarize incident root cause.",
});
console.log(res.output[0].content[0].text, client.lastResponse?.cost);

Headers & Errors

Inbound: Authorization: Bearer sk-nrouter-... and Content-Type: application/json. Optional: x-nr-tags, x-nr-compress. Telemetry: x-nr-request-id, x-nr-latency-ms, x-nr-request-cost, x-nr-cost-status, x-nr-model, x-nr-routing, x-nr-attempts, x-nr-guardrails, x-nr-response-cache. See Chat Completions.

curl -X POST "https://example.com/v1/responses" \  -H "Content-Type: application/json" \  -d '{    "model": "gpt-5.4-mini",    "input": "Explain how prompt injection defense operates before credit reservation."  }'

{  "id": "resp_01",  "object": "response",  "status": "completed",  "output": [    {      "type": "message",      "role": "assistant",      "content": [        {          "type": "output_text",          "text": "Hello!"        }      ]    }  ]}