Getting Started

Prerequisites

An endpoint key - publish a playbook, then open Deploy as Endpoint → Manage API Keys in the Playground.
Basic REST knowledge. That’s it - no SDK required for this page.

Authentication

Requests to the Chat API carry one header:

Authorization: Bearer $UNPOD_API_KEY

Unpod has two credentials, and they are not interchangeable:

You are calling	Host	Header	Key from
Chat API (this page)	`inference.unpod.ai`	`Authorization: Bearer`	Playground → Deploy as Endpoint
Python SDK (pipes, numbers, runner)	`api.unpod.ai`	handled by the SDK	unpod.ai/api-keys

The SDK reads its key from UNPOD_API_KEY too - set whichever one matches the path you are on.

Your first request

Every trained agent is callable over the same chat/completions shape you already know. model is the agent - here, a public example playbook:

curl https://inference.unpod.ai/v1/chat/completions \
  -H "Authorization: Bearer $UNPOD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"public:PB_7ZRMzCA1ojQ9LlcK","messages":[{"role":"user","content":"hi"}]}'

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "Hi! Welcome to Lumina Spa - I'm Mira, your booking assistant. How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ]
}

Not a generic reply - a trained persona, following its own playbook.

Keep the conversation

Add a user id and the agent remembers the thread across requests:

curl https://inference.unpod.ai/v1/chat/completions \
  -H "Authorization: Bearer $UNPOD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"public:PB_7ZRMzCA1ojQ9LlcK","messages":[{"role":"user","content":"hi"}],"user":"sess_abc"}'

Go further

Train your own

Describe your use case in the Playground; the playbook writes itself.

Use it over chat

Drop the endpoint into LiveKit, Pipecat, or any chat workflow.

Use it in realtime

Give it a voice - speech in, speech out, brain included.

Put it on a number

No code - publish straight to a live phone number.

Start Here

Use it like a model

Prerequisites

Authentication

Your first request

Keep the conversation

Go further

Train your own

Use it over chat

Use it in realtime

Put it on a number

​Prerequisites

​Authentication

​Your first request

​Keep the conversation

​Go further

Train your own

Use it over chat

Use it in realtime

Put it on a number

Prerequisites

Authentication

Your first request

Keep the conversation

Go further