Playground
Compose a request against the public API and read the exact bytes it sends back. For a conversation, use the chat app; this page is the wire.
Request
POST /api/v1/chatModel
gpt-oss-20b
The one model this endpoint serves. Any other id is refused with model_not_in_scope.
Up to 24 messages, 8,000 characters each. Prompts are never stored.
Body
{
"model": "gpt-oss-20b",
"messages": [
{
"role": "user",
"content": "Explain a token bucket in two sentences."
}
]
}Response
200 · application/jsonShape
{
"id": "pbcmpl_m1k2j3",
"object": "chat.completion",
"created": 1757376000,
"model": "gpt-oss-20b",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "A token bucket…"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 18,
"completion_tokens": 42,
"total_tokens": 60
}
}Headers on every authenticated response, success and 429 alike
- x-prabloe-ratelimit-requests-limit
- x-prabloe-ratelimit-requests-remaining
- x-prabloe-ratelimit-requests-reset
- x-prabloe-provider
Streaming is not served yet: stream: true is refused rather than quietly downgraded to one blob.
Errors
every code this endpoint can return| Status | Code | When |
|---|---|---|
| 404 | — | The endpoint is not enabled on this deployment. |
| 401 | invalid_key | Missing, unknown, publishable, or sent from a browser. |
| 401 | key_revoked | A well-formed key that no longer verifies. |
| 403 | insufficient_scope | A live key that is not scoped to this route. |
| 400 | model_not_in_scope | Any model other than "gpt-oss-20b". |
| 400 | invalid_request | Bad JSON, empty messages, or stream: true. |
| 429 | rate_limited | Per-key burst limit. Read retry-after. |
| 402 | spend_limit_reached | The key's daily call or USD budget is spent. |
| 502 / 503 | unavailable | No provider reachable, or an unusable reply. |
Run it
not from this pageA pb_secret_ key is refused when it arrives from a browser — one that reached us this way has already been shipped to end users. Copy the request above and run it from your server or terminal. For an interactive conversation, the chat app is the surface.