Getting Started

Prerequisites

An Unpod account and API key - unpod.ai/api-keys, or from the Playground’s Deploy as Endpoint → Manage API Keys.
Basic REST knowledge. That’s it - no SDK required for this page.

Authentication

Every request carries one header:

Authorization: Bearer $UNPOD_API_KEY

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.

Core ConceptsThe single source of truth for Unpod terminology - every term defined once, with deep links.

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