Standard
Every key, by default. Standard runs on GPUs that also mine $PEARL, which keeps prices low. Your data never leaves the machine. Only a signed claim does, and for found blocks, a zero-knowledge proof that reveals nothing about the request.
The Peryn API: four top open models, OpenAI-compatible. Change the base URL and the key, and keep your code. Every request mines while it answers. For your company, talk to us about invoicing and a Private tier.
01
Get a key
Sign in to the console and create a key. Add credit with USD stablecoins under Add credits.
02
Set the base URL
https://api.peryn.ai/v1
03
Send a request
Any OpenAI SDK. Streaming works the same way.
Python
2 lines changed
import osfrom openai import OpenAI client = OpenAI(Removed: base_url="https:// api. openai. com/ v1",Removed: api_key=os. environ["OPENAI_API_KEY"],Added: base_url="https:// api. peryn. ai/ v1",Added: api_key=os. environ["PERYN_API_KEY"],) reply = client. chat. completions. create( model=MODEL, messages=messages,)JavaScript
2 lines changed
import OpenAI from "openai"; const client = new OpenAI({Removed: baseURL: "https:// api. openai. com/ v1",Removed: apiKey: process. env. OPENAI_API_KEY,Added: baseURL: "https:// api. peryn. ai/ v1",Added: apiKey: process. env. PERYN_API_KEY,}); const reply = await client. chat. completions. create({ model: MODEL, messages,});
MODEL is one of the model ids below, for example deepseek-v4.1-flash-1017.
Each with a context of a million tokens, each with its own page: what it does best, the facts from its model card, a call to it.
When every GPU serving a model is busy, you get HTTP 429 with Retry-After at once. When none is serving it, we hold the request for up to 4 minutes for one to come online. If none does, you get HTTP 503 and pay nothing.
Every request on the Peryn API mines $PEARL as it is served: inside the AI work, and in the gaps between requests. The GPUs earn twice on the same compute.
Send many requests in one file and set the most you want to pay. GPUs bid for the job, and the lowest bid runs it.
OpenAI-compatible. Send your key as a Bearer token.
https://api.peryn.ai/v1
/chat/completionsChat, streamed or in one piece.API key/completionsText completion from a prompt.API key/modelsEvery model: id, context, price.No key/models/{id}One model.No key/catalogPrices per 1M tokens and context, per model.No keySet stream to true. Tokens arrive as server-sent events, and the stream ends with data: [DONE].
import osfrom openai import OpenAI client = OpenAI(base_ url= "https:// api. peryn. ai/ v1",api_ key= os. environ[ "PERYN_ API_ KEY"],) stream = client. chat. completions. create(model= "deepseek-v4.1-flash-1017",messages=[ {"role": "user", "content": "Hello"}],stream=True,)for chunk in stream:if chunk. choices:print( chunk. choices[ 0]. delta. content or "", end="")text/event-stream
: ping
data: {…, "choices": [{"index": 0, "delta": {"role": "assistant", "content": "Hel"}}]}
data: {…, "choices": [{"index": 0, "delta": {"content": "lo."}}]}
data: {…, "choices": [], "usage": {"prompt_tokens": 9, "completion_tokens": 2, "total_tokens": 11}}
data: [DONE]
Add stream_options.include_usage for token counts in the last chunk.
Lines that start with a colon keep the connection open; OpenAI SDKs skip them.
Each API key has a tier, for one developer or a whole company. Neither stores prompts or answers, and we never train on them.
Every key, by default. Standard runs on GPUs that also mine $PEARL, which keeps prices low. Your data never leaves the machine. Only a signed claim does, and for found blocks, a zero-knowledge proof that reveals nothing about the request.
For companies with compliance needs. Never mined. Vetted nodes only, region rules, priced from GPU cost.
Talk to us about PrivateRequests on our Private and Confidential tiers are never mined. Compute privacy
Set region rules, such as EU only, for your account or one key in the console. Every response a GPU served names its country in x-pc-node-country.
You pay for the tokens each request used.
Prepaid credit
Too little credit for the hold: 402. A lower max_tokens keeps holds small.
Limits per key
The defaults. A request counts its prompt plus max_tokens, and gets back what it did not use. Over a limit: 429 with Retry-After.
Every error has the same JSON body. OpenAI SDKs raise it with the status code.
Response
HTTP/1.1 402 Payment Required
{ "error": { "message": "Not enough credit for this request. Lower max_tokens, or get more credit: see the console.",For people. Log it or show it. "type": "insufficient_quota",The kind of error. "param": null,The field at fault, when there is one. "code": "insufficient_quota"Stable. Branch on it. }}| Status | Code and what to do |
|---|---|
| 400 | invalid_jsonunsupported_parameter Fix the request. A retry gives the same answer. |
| 401 | missing_api_keyinvalid_api_keyrevoked_api_key Check the key in the Authorization header. |
| 402 | insufficient_quota Add credit in the console, or lower max_tokens. |
| 404 | model_not_found Use a model id from /models. |
| 429 | rate_limit_exceeded A rate limit is reached. Wait for Retry-After, then retry. |
| 429 | no_capacity Every GPU serving this model is busy. Wait for Retry-After, then retry. |
| 503 | no_capacityno_capacity_in_region No node serves this model right now, or none in your key’s regions. Wait for Retry-After, then retry. |
| 504 | timeout Retry, or lower max_tokens. |
Every code, in full: API docs
The API is prepaid in US dollars, excluding VAT, and each request is charged against your credit. You add credit with USD stablecoins (USDC), sent to your account’s own deposit address under Add credits in the console. Credit is added one to one once the deposit is final. There is no card checkout. The free chat tokens need no credit.
Monthly invoices for businesses: talk to usBy tokens, counted with each model’s own tokenizer. When a request starts, we hold enough credit for its input plus its longest possible answer (max_tokens). When it ends, we charge what it used and release the rest. Without enough credit, the request is refused with HTTP 402.
Unused credits expire after 12 months without activity on your account. Activity means signing in, a request charged to your credits, or buying credits. We email you at least 30 days before.
Each API key allows 60 requests and 200,000 tokens per minute by default, and the console shows each key’s limits. Over a limit you get HTTP 429 with a Retry-After header.
Need more? Talk to usRequests never queue behind busy GPUs. When every GPU serving a model is busy, you get HTTP 429 with a Retry-After header at once. When none is serving it, we hold the request for up to 4 minutes for one to come online. If none does, you get HTTP 503. A request that is not served costs nothing.
We do not log or store prompt or completion content, and never train on it. How mining affects your data:
Compute privacy