curl -X POST "https://api.hooked.so/v1/voice/speech" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "voiceId": "tzX5paJ07p5hyWFcU3uG",
    "text": "Stop scrolling. This serum changed my morning routine in one week.",
    "audio": { "speed": 1.05, "stability": 0.5, "similarityBoost": 0.75 },
    "name": "Serum hook"
  }'

const response = await fetch("https://api.hooked.so/v1/voice/speech", {
  method: "POST",
  headers: { "x-api-key": process.env.HOOKED_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    voiceId: "tzX5paJ07p5hyWFcU3uG",
    text: "Stop scrolling. This serum changed my morning routine in one week.",
  }),
});
const { data } = await response.json();
// The link works for 10 minutes
const audio = await fetch(data.url).then((res) => res.arrayBuffer());

import os
import requests

response = requests.post(
    "https://api.hooked.so/v1/voice/speech",
    headers={"x-api-key": os.environ["HOOKED_API_KEY"]},
    json={
        "voiceId": "tzX5paJ07p5hyWFcU3uG",
        "text": "Stop scrolling. This serum changed my morning routine in one week.",
    },
)
data = response.json()["data"]
with open("speech.mp3", "wb") as file:
    file.write(requests.get(data["url"]).content)

{
  "success": true,
  "message": "Speech generated",
  "data": {
    "voiceoverId": "cm4xa3d4e0002ab12cd34ef56",
    "url": "https://files.hooked.so/team/public/media/voiceover/voiceover-1759660800000.mp3?X-Amz-Signature=...",
    "urlExpiresInSeconds": 600,
    "durationSeconds": 4.6,
    "characters": 66,
    "creditsUsed": 5
  }
}

{
  "success": false,
  "message": "voiceId: Voice \"abc123\" not found."
}