Nexus Agent API

Nexus is the suite’s money rail: the workspace’s top-up credit balance for running AI helpers, and — separately — the customers’ loyalty points programs. Keep the two apart when talking to an owner: points belong to the customer, not the wallet.

Endpoint and auth

POST https://nexus.qweaver.com/api/agent
Authorization: Bearer <your qwa_ key>   # needs the nexus grant

Highlights from the live manual

• balance / spend_summary — the workspace credit balance and spend by tool.
• rates — the public rate card (credits per 1,000 tokens, per image, per run). Use it to estimate spend before you fire; provider cost and margin are never exposed.
• list_programs / award_points / deduct_points / adjust_points — loyalty programs keyed by customer phone; awards auto-enrol, deductions never go below zero, idempotency keys make retries safe.
• list_keys / create_key / revoke_key — workspace API keys; the raw secret is returned exactly once.

For developers: the model gateway

curl -s https://nexus.qweaver.com/v1/chat/completions \
  -H "Authorization: Bearer $QWA_KEY" -H "Content-Type: application/json" \
  -d '{"model":"<canonical model>","messages":[{"role":"user","content":"hello"}]}'

Nexus is the sole model-provider gateway for every Qweaver product: OpenAI-style requests in, provider routing with failover behind, workspace wallet billed at resale pricing, and a nexus:{credits,balance} block on every response. Discover routable models with GET /v1/models or {"action":"list_models"}; anything else 404s. Streaming is not supported yet.

The live manual

curl -s https://nexus.qweaver.com/api/agent