Developer center

From the smallest request to error handling, streaming settlement, and Trace drill-down.

Production integration

Turn an invocation into a recoverable, settlement-ready business outcome.

A business record establishes the idempotency boundary; the gateway handles reservation, model routing, and usage reporting. Applications decide only by stable code 和 retryable signals.

REST address: https://nexus-api.rainlib.com
Authentication: Bearer API Key
Idempotency: X-Nexus-Operation-Key
Tracing: W3C traceparent

01 / Smallest runnable call

Use a published capability route first, then fix the business transaction.

Do not send an upstream provider key; Nexus resolves the model alias, offer, token cap, and pricing snapshot.

1AuthenticateThe API key determines the customer and scope.

2ReserveReserve the maximum risk amount.

3ExecuteRoute to a published provider.

4SettleSubmit usage and refund the difference.

Current public REST endpointhttps://nexus-api.rainlib.com

OpenAI-compatible requestcURL

export NEXUS_API_URL="https://nexus-api.rainlib.com"

curl "$NEXUS_API_URL/v1/openai/chat/completions" \
  -H "Authorization: Bearer $NEXUS_API_KEY" \
  -H "X-Nexus-Operation-Key: order-2026-00042" \
  -H "traceparent: 00-<trace-id>-<span-id>-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"support-chat","messages":[{"role":"user","content":"..."}]}'

modelEnter only the route alias published by the capability, for example support-chat。

operation keyKeep it unchanged across retries of the same business transaction to avoid duplicate reservations.

traceparentOptional. After forwarding it, inspect model, tool, and billing stages from Trace.

正在加载页面内容。

export NEXUS_API_URL="https://nexus-api.rainlib.com" curl "$NEXUS_API_URL/v1/openai/chat/completions" \ -H "Authorization: Bearer $NEXUS_API_KEY" \ -H "X-Nexus-Operation-Key: order-2026-00042" \ -H "traceparent: 00-<trace-id>-<span-id>-01" \ -H "Content-Type: application/json" \ -d '{"model":"support-chat","messages":[{"role":"user","content":"..."}]}'