---
title: "Speak"
method: POST
path: "/speak"
---

# Speak

`POST /speak`

## Request

- Base URL: `https://api.voicelabs.now` (the document declares no server; this is the origin it was published from)
- URL: `https://api.voicelabs.now/speak`
- Auth: none declared

Speak text in a voice profile. Mirrors voicebox.speak (MCP).

Response shape matches POST /generate — a ``GenerationResponse`` with
``status="generating"`` and an ``id`` the caller polls at
``GET /generate/{id}/status``.

## Request body

- SpeakRequest: Body for POST /speak — non-MCP REST surface that mirrors voicebox.speak.
  - `text` string, required
  - `profile` string, nullable: Voice profile name or id. Falls back to per-client binding, then default.
  - `engine` string, nullable
  - `personality` boolean, nullable: When true and the profile has a personality prompt, the input text is rewritten in-character before TTS. When null, the per-client binding's default_personality flag decides.
  - `language` string, nullable
  - `seed` integer, nullable: See GenerationRequest.seed.
  - `temperature` number, nullable: See GenerationRequest.temperature.

## Response `200`

Successful Response

- GenerationResponse: Response model for voice generation.
  - `id` string, required
  - `profile_id` string, required
  - `text` string, required
  - `language` string, required
  - `audio_path` string, nullable
  - `duration` number, nullable
  - `seed` integer, nullable
  - `instruct` string, nullable
  - `engine` string, nullable
  - `model_size` string, nullable
  - `speed` number, nullable
  - `temperature` number, nullable
  - `chunk_count` integer, nullable
  - `status` string
  - `error` string, nullable
  - `is_favorited` boolean
  - `source` string
  - `created_at` string, date-time, required
  - `versions` GenerationVersionResponse[], nullable
    - `id` string, required
    - `generation_id` string, required
    - `label` string, required
    - `audio_path` string, required
    - `effects_chain` EffectConfig[], nullable
      - `type` string, required
      - `enabled` boolean
      - `params` object
    - `source_version_id` string, nullable
    - `is_default` boolean, required
    - `created_at` string, date-time, required
  - `active_version_id` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/voicelabs/apis/voicebox-api.md) · [All operations](https://skmtc.dev/voicelabs/apis/voicebox-api/llms.txt) · [OpenAPI document](https://skmtc.dev/voicelabs/apis/voicebox-api/revisions/a7a37d1fc02f?raw)