Bluwing/Docsv0.9.0
Operational
API ReferenceConsole

Get started

  • Introduction
  • Quickstart
  • How it works

Build

  • Tool format
  • Matching hints
  • Toolsets and builds
  • Versions and live

Call

  • Resolve a request
  • Reading responses
  • OpenAI and Anthropic compatibility

Account

  • Authentication
  • Credits and billing
  • Limits
  • Errors
  • Security and data
  • FAQ

Account

Authentication

Your API key, where it goes, and how to keep it safe.

Every request carries your API key in the Authorization header:

bash
curl https://api.bluwing.si/v1/chat/completions \
  -H "Authorization: Bearer $BLUWING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "model": "bluwing", "messages": [{ "role": "user", "content": "Ping" }] }'

#Your key

Each account has one key. Find it on the console's API key page. Showing it asks you to confirm your password if you signed in more than 15 minutes ago, and the page records when it was last shown.

Keys look like rk_live_ or rk_test_, then an 8-character id, then a 40-character secret. The prefix up to the id is safe to log; the rest is not.

A key can do everything an account can through the API: build and delete toolsets, and send requests. It can't change your plan or buy credits; those happen in the console.

#Requests with a body

Send JSON with Content-Type: application/json. Anything else answers 415 UNSUPPORTED_MEDIA_TYPE. Bodies are limited to 1 MiB (413 PAYLOAD_TOO_LARGE).

#When it goes wrong

StatusCodeCause
401INVALID_API_KEYMissing, malformed, wrong or revoked key.
403FORBIDDENThe key exists but isn't allowed to do this.

#Keeping it safe

  • Call from your server. A key in a web page or a mobile app can be read by anyone who has the app.
  • Load it from the environment or a secret manager. Don't commit it.
  • Don't log full request headers.
  • If it leaks, write to [email protected] from your account's email address. We revoke it and issue a new one the same day. Self-serve rotation is coming.

Every response has an X-Request-Id header. Include it when you contact support about a request.

PreviousOpenAI and Anthropic compatibilityNext Credits and billing

Something unclear or missing? Write to [email protected] and we'll fix the page.

On this page

  • Your key
  • Requests with a body
  • When it goes wrong
  • Keeping it safe