AI narration, one POST away

Quick start

1. Create an account and pick a plan (from $4/month — every plan includes monthly credits).
2. Create an API key on your dashboard.
3. POST your text — get an MP3 back.

curl https://vidsly.ai/api/v1/tts \
  -H "Authorization: Bearer ksk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Three numbers came out this morning, and every one of them moved the market.",
    "voice": "azure-aria",
    "speed": "normal"
  }' \
  --output story.mp3

MCP — drive the studio from inside Claude

Add our MCP server to Claude Code or Claude Desktop and just ask: "Narrate this script in Aria's voice and send me the MP3." The file or a watch link comes back in the chat. Presenter videos cost 500 credits; audio narration is 1 credit per 10 characters.

{
  "mcpServers": {
    "vidsly": {
      "command": "npx",
      "args": ["-y", "vidsly-mcp"],
      "env": { "VIDSLY_API_KEY": "ksk_live_..." }
    }
  }
}

Tools: create_talking_storybook · get_storybook_status · list_characters · create_audio_story — package: vidsly-mcp

▶️ Try it

Hear any voice before you integrate. (Uses your account's character allowance — no API key needed here.)

POST /api/v1/tts

const res = await fetch("https://vidsly.ai/api/v1/tts", {
  method: "POST",
  headers: {
    "Authorization": "Bearer ksk_live_YOUR_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    text: "Os mercados abriram em silêncio esta manhã…",
    voice: "azure-pt-francisca",
    format: "json", // base64 instead of binary
  }),
});
const { audio, credits_charged } = await res.json();

Errors are JSON: { "error": { "code", "message" } } — 401 bad key, 402 not enough credits, 400 invalid input or content rejected, 429 rate limited. You are never charged for a failed request.

Pricing

1 credit per 10 characters (minimum 1 credit per request), from the same credit balance as the rest of Vidsly. Every plan includes monthly credits — from 5,000 on Basic ($4/month) up to 200,000 on Studio — so roughly $0.045–0.06 per 1,000 characters. Unused credits bank for 90 days.

Content safety

Every request is screened by an AI moderation layer before synthesis. Text that falls outside our content policy is rejected (HTTP 400 content_rejected, no charge): sexual content, hate speech, threats against real people, instructions for violent wrongdoing, and graphic gore. Reporting on a difficult subject is fine — depicting it explicitly is not, so true crime, war, hard news and politics all pass. If the moderation provider is unreachable the request fails closed with a 503 rather than being synthesised unchecked.