> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pawa-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get started with Pawa AI and integrate powerful AI capabilities in minutes

Follow these steps to start using Pawa AI models in your applications.

***

### Step 1: Create a Pawa AI Account

* Sign up for a Pawa AI account [Register](https://pawa-ai.com/auth).
* Verify your email and log in as a Builder

### Step 2: Generate an API Key

* Navigate to the **API Keys** page in your [Builders Dashboard](https://builder.pawa-ai.com/dashboard).
* Click **Create new key**.
* Copy the key and save it securely. We recommend storing it as an environment variable:

```bash theme={null}
export PAWA_AI_API_KEY="your_api_key_here"
```

### Step 3: Make Your First API Call

<Tabs>
  <Tab title="Chat" icon="message">
    With your API key set, you can make your first chat request:

    ```bash theme={null}
    curl https://api.pawa-ai.com/v1/chat/request \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer $PAWA_AI_API_KEY" \
      -d '{
        "model": "pawa-v1-ember-20240924",
        "messages": [
          {
            "role": "system",
            "content": [
              {
                "type": "text",
                "text": "You are a TanzaBot, a helpful AI assistant for developers in Africa."
              }
            ]
          },
          {
            "role": "user",
            "content": [
              {
                "type": "text",
                "text": "Hello, How can I use AI in my app?"
              }
            ]
          }
        ],
        "stream": false
      }'
    ```

    You should receive a JSON response with Pawa's chat completion.
  </Tab>

  <Tab title="Text to Speech" icon="microphone">
    Convert text to speech:

    ```bash theme={null}
    curl https://api.pawa-ai.com/v1/voice/text-to-speech \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer $PAWA_AI_API_KEY" \
      -d '{
        "model": "pawa-tts-v1-20250704",
        "text": "Hello, this is Pawa AI speaking!",
        "voice": "liora"
      }'
    ```

    You'll receive an audio file in the response. We technically do auto streaming of speech(text to speech), so if need that please send request as as streaming using server sent events(SSE).
  </Tab>

  <Tab title="Speech to Text" icon="microphone">
    Convert speech to text:

    ```bash theme={null}
    curl https://api.pawa-ai.com/v1/voice/speech-to-text \
      -H "Authorization: Bearer $PAWA_AI_API_KEY" \
      -F "file=@audio_file.wav" \
      -F "model=pawa-stt-v1-20240701"
    ```

    The response will contain the transcribed text.
  </Tab>

  <Tab title="Embeddings" icon="draw-polygon">
    Generate embeddings for NLP tasks:

    ```bash theme={null}
    curl https://api.pawa-ai.com/v1/vectors/embedding \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer $PAWA_AI_API_KEY" \
      -d '{
        "model": "pawa-embeddings-v1-20241001",
        "input": ["Embed this sentence.", "And this one too."],
        "lang":"multi"
      }'
    ```

    The response will include numerical vectors for each input text. The list of vector representations of each sentence.
  </Tab>

  <Tab title="Document Parsing" icon="files">
    Parse documents to extract text:

    ```bash theme={null}
    curl https://api.pawa-ai.com/v1/documents/parse \
      -H "Authorization: Bearer $PAWA_AI_API_KEY" \
      -F "documents=@document.pdf" \
      -F "model=pawa-v1-parser-20250809"
    ```

    The response will contain the extracted textual data.
  </Tab>
</Tabs>

***

## Next Steps

Now that your account is ready and you've made your first requests, explore other Pawa AI's capabilities:

<CardGroup cols={2}>
  <Card title="Tools calling" icon="wrench" href="/capabilities/tools-calling">
    Enable your AI to call external tools and APIs for enhanced functionality.
  </Card>

  <Card title="Reasoning" icon="brain" href="/capabilities/reasoning">
    Build AI systems that can think through complex problems step by step.
  </Card>

  <Card title="Agents" icon="brain" href="/agents/introduction">
    Create autonomous AI agents that can perform multi-step tasks independently.
  </Card>

  <Card title="Multimodal" icon="image" href="/capabilities/vision">
    Process text, images, and other media types in a single AI conversation.
  </Card>
</CardGroup>

<Note>
  **Need help?** Check the [API Reference](/api-reference/introduction) or visit our [Sandbox](https://builder.pawa-ai.com/dashboard?page=sandbox) to test the models.
</Note>