Skip to main content
This guide takes you from a brand-new account to a live API response in under five minutes. By the end, you will have made a real inference request against the Pinaivu gateway and verified it on the explorer.
1

Create an account

Visit api.pinaivu.com and sign up for a free account. You can register with an email address or a supported OAuth provider. Once your account is created, you will land in the dashboard.
2

Get your API key

In the dashboard, navigate to API Keys and click Generate. Pinaivu will create a new key that begins with sk-pnv-.Copy the key immediately — it is only shown once. Treat it like a password: do not share it and do not commit it to version control. Store it in an environment variable or a secrets manager.
sk-pnv-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
3

Make your first request

Use the curl command below to send a chat completion request. Replace sk-pnv-... with your actual key.
curl https://api.pinaivu.com/v1/chat/completions \
  -H "Authorization: Bearer sk-pnv-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "llama3.2:1b",
    "messages": [
      {"role": "user", "content": "What is decentralized AI inference?"}
    ]
  }'
A successful response looks like this:
{
  "id": "chatcmpl-a1b2c3d4e5f6",
  "object": "chat.completion",
  "created": 1735000000,
  "model": "llama3.2:1b",
  "request_id": "pnv_req_9xKz2mTqL8vR4wYn",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Decentralized AI inference distributes model execution across a network of independent GPU operators rather than relying on a single centralized provider. Requests are brokered cryptographically, and every completed inference is backed by a verifiable proof."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 48,
    "total_tokens": 60
  }
}
4

Verify your inference

Notice the request_id field in the response — for example, pnv_req_9xKz2mTqL8vR4wYn. Copy that value and visit explorer.pinaivu.com.Paste the request_id into the search bar. The explorer shows you:
  • Which GPU node served your request
  • The payment settlement record
  • The coordinator’s signed routing receipt — your cryptographic proof of inference
The Pinaivu gateway is fully OpenAI-compatible. Any application or SDK that supports a custom base_url can be pointed at https://api.pinaivu.com/v1 with your sk-pnv- key and will work without any other code changes.
Want to use the Python or Node.js OpenAI SDK instead of curl? See the OpenAI SDK guide for drop-in examples.