Call the OpenAgents API (Open Responses and Chat Completions, many models, one key) and read its docs. Use when a task needs a model through OpenAgents, or asks what OpenAgents models cost.
Install
npx skillscat add openagentsinc/openagents/openagents-api Install via the SkillsCat registry.
OpenAgents API
One API for many models. It speaks Open Responses and the OpenAI Chat
Completions API, so OpenAI SDKs work with two changes. Beta.
| Base URL | https://api.openagents.com/v1 (https://openagents.com/api/v1 and https://openagents.com/v1 still answer but are deprecated) |
| Key | Authorization: Bearer $OPENAGENTS_API_KEY (an oak_ key) |
| Docs | https://openagents.com/docs/api.md |
| Prices | https://openagents.com/docs/api/models.md |
| Getting a key | https://openagents.com/auth.md |
| Docs for agents | https://openagents.com/docs/agents/start-here.md |
Steps
Read the key from
OPENAGENTS_API_KEY. If it is missing, tell the person
to make one at https://openagents.com/settings/api-keys, or sign up as
an agent yourself (https://openagents.com/docs/agents/sign-up.md); never
ask for it in chat or write it to a file.Send a request:
curl https://api.openagents.com/v1/responses \ -H "Authorization: Bearer $OPENAGENTS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "openagents/chat", "input": "Say hello."}'openagents/chatlets OpenAgents pick the model. Name one (see the
prices page) to choose it yourself.With an OpenAI SDK, set
base_urltohttps://api.openagents.com/v1and
pass the key as the API key.On
429, wait forRetry-After. On402, the balance is too low; tell
the person. Every answer has anx-request-idto quote when asking for
help.
Reading the docs as tools
The docs MCP server at https://openagents.com/mcp/docs (Streamable HTTP,
no key) has list_docs, search_docs, read_doc, and list_models.
More tasks
Each is a page with the exact requests, as Markdown:
- Sign up as an agent: https://openagents.com/docs/agents/sign-up.md
- Buy credits over Lightning: https://openagents.com/docs/agents/buy-credits.md
- Stream an answer or start a chat: https://openagents.com/docs/agents/chat-and-stream.md
- Typed decisions: https://openagents.com/docs/agents/decisions.md
- Projects, files, invitations: https://openagents.com/docs/agents/projects.md
- Coder headless: https://openagents.com/docs/agents/coder-headless.md
- Every endpoint: https://openagents.com/docs/agents/endpoints.md
- Every error code: https://openagents.com/docs/agents/errors.md