Documentation

API Reference

Authentication

All API requests require a Bearer token:

Authorization: Bearer YOUR_API_KEY

Endpoints

POST /v1/sessions

Create a new voice session.

// Request
{
  "backend": "claude",        // optional: "claude" | "openai" | "openclaw"
  "systemPrompt": "...",      // optional
  "responseMode": "audio",    // optional: "text" | "audio" | "both"
  "tts": {
    "voice": "nova",          // optional
    "speed": 1.0              // optional
  }
}

// Response
{
  "sessionId": "...",
  "websocketUrl": "wss://talkwire.io/v1/stream/...",
  "expiresAt": "..."
}

// Response modes:
// "text"  - No TTS, just text streaming (fastest)
// "audio" - TTS audio only (default)
// "both"  - Text streaming + TTS audio

GET /v1/sessions/:id

Get session information.

DELETE /v1/sessions/:id

End a session.

GET /v1/me

Get your API key information.

GET /v1/usage

Get your usage statistics.