30817:ai-agent-keys
AI Agent Keys
A user stores the API key of their AI provider so every client they sign into can run AI tasks for them, billed to the user.
Event
Kind 12000, replaceable, no required tags. content is a NIP-44 ciphertext,
encrypted by the author to themselves, of a JSON array of tags:
[["key", "sk-or-v1-…", "https://openrouter.ai/api/v1"]]
keyindex 1: the key, or""for an endpoint that takes none.keyindex 2: the root of an API serving the OpenAI Chat Completions format. It MUST behttps, unless the key is empty or the host is loopback (localhost,127.0.0.0/8,::1). Readers strip a trailing/.
Readers ignore key tags with no URL or a URL breaking that rule, and key tags in the
public tags. The first remaining one is the default; the others are alternatives in order
of preference.
Use
Send the key as Authorization: Bearer <key> to its own URL only (no header for an empty
key): POST <url>/chat/completions. GET <url>/models checks a key at no cost, though some providers answer it without
looking at the key. Clients
SHOULD name the provider and model before spending for the first time, and treat a 401
or 403 as a rejected key.
Users SHOULD store keys made for this purpose, each with a spending limit set at the provider.
Security
Anyone holding the user's private key, or allowed to NIP-44 decrypt for them, can spend up to the key's limit. Clients never log the key or put it in a URL.
Discussion
Connect a key to comment.