The chat completions endpoint is OpenAI-compatible, so most OpenAI SDKs and tools work by changing only the base URL and API key. Enable inference first to mint your privateKey, then send requests.
Endpoint
POST https://agents.pinata.cloud/v0/llm/chat/completions
| |
|---|
| Auth | Authorization: Bearer <PINATA_LLM_KEY> — the privateKey returned when you enabled, not your Pinata JWT |
| Content-Type | application/json |
| Billing | Token usage draws down credits |
For an OpenAI-compatible client, set the base URL to https://agents.pinata.cloud/v0/llm — the SDK appends /chat/completions itself.
Request
curl https://agents.pinata.cloud/v0/llm/chat/completions \
-H "Authorization: Bearer $PINATA_LLM_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "anthropic/claude-sonnet-4-6",
"messages": [
{ "role": "user", "content": "Hello!" }
]
}'
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.PINATA_LLM_KEY,
baseURL: "https://agents.pinata.cloud/v0/llm",
});
const completion = await client.chat.completions.create({
model: "anthropic/claude-sonnet-4-6",
messages: [{ role: "user", content: "Hello!" }],
});
console.log(completion.choices[0].message.content);
Parameters
| Field | Type | Description |
|---|
model | string | A provider/model id from Models |
messages | array | Conversation history (role + content) |
stream | boolean | Stream tokens as server-sent events. Defaults to false |
max_tokens / max_completion_tokens | number | Output token cap. Defaults to 4096 if neither is set. For OpenAI gpt-5.x / o-series models, max_tokens is translated to max_completion_tokens for you |
temperature, top_p, etc.) are passed through to the underlying model.
Response
{
"id": "chatcmpl-...",
"object": "chat.completion",
"model": "anthropic/claude-sonnet-4-6",
"choices": [
{
"index": 0,
"message": { "role": "assistant", "content": "Hi there!" },
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 0,
"completion_tokens": 0,
"total_tokens": 0
}
}
Streaming
Set "stream": true to receive server-sent events. Usage is included in the stream, and the final event is data: [DONE].
curl https://agents.pinata.cloud/v0/llm/chat/completions \
-H "Authorization: Bearer $PINATA_LLM_KEY" \
-H "Content-Type: application/json" \
-d '{ "model": "anthropic/claude-sonnet-4-6", "messages": [...], "stream": true }'
Errors
| Status | Meaning |
|---|
401 | Missing Authorization header, or an invalid/revoked key |
402 | Insufficient credits — top up or set auto top-up. The body includes availableMicrocredits |
429 | Rate limited — retry after a short wait |
{ "error": { "message": "..." } }. 
