Skip to content

Developer hub

Build on Hetafwith one key.

Chat models, speech-to-text and text-to-speech, WhatsApp, and voice sessions for your agents. One API key, one balance in riyals, and a chat API in the OpenAI format.

Quickstart

Your first request
in three steps.

  1. Create your account

    The Free plan needs no card. Sign up and you land straight in the dashboard.

  2. Create an API key

    Under Keys in the dashboard, create a key that starts with ht_… and pick its scopes. It is shown once, so keep it somewhere safe.

  3. Send your first request

    Put the key in the Authorization header and send the request, or change the base URL and key in the OpenAI library you already use.

The same request, three ways

curl https://api.hetaf.ai/api/v1/chat/completions \
  -H "Authorization: Bearer ht_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hetaf-chat",
    "messages": [
      { "role": "user", "content": "Say hello." }
    ]
  }'

Ask AI about Hetaf

Models

Hetaf models.

Pass the id in the model field. GET /api/v1/models returns the full list, with prices in riyals.

  • Chat completions

    Read the docs
    • hetaf-chatDefault

      Arabic and English conversation, with tool calling and streaming.

    • hetaf-chat-pro

      Higher capability for complex requests outside voice calls.

  • Speech to text

    Read the docs
    • hetaf-sttDefault

      Arabic and English transcription, pre-recorded and live.

    • hetaf-stt-saudiArabic only

      Saudi-dialect Arabic: Najdi, Hijazi and Gulf. The model Hetaf voice agents listen with on Arabic calls.

  • Text to speech

    Read the docs
    • hetaf-ttsDefault

      Arabic and English speech, in a voice you pick from the voice catalogue.

Connect your tools

Hetaf inside your assistant.
Its events in your systems.

Hetaf MCP connector

Connect Claude or any MCP-capable assistant to your account and let it run agents, calls, WhatsApp and customers when you ask.

Server address

https://api.hetaf.ai/mcp

Webhooks

Signed events sent to your URL the moment something happens: a call starts or ends, a WhatsApp message arrives, a customer asks for a person.

Example events

  • call.started
  • call.ended
  • call.analyzed
  • whatsapp.message.received
  • conversation.handoff_requested
  • contact.created
  • deal.stage_changed
  • ticket.created
  • And more in the dashboard

Ready to build?

Start on the Free plan, create your key and send your first request today.