Create a Voice-over API

Write a text and choose a voice: it is read aloud and saved as an MP3, ready for a video, an ad or a product page.

POST/v1/generateworkflow: voice_over-v1

One endpoint serves every workflow — this page documents voice_over-v1, the current version. Credits are debited at submission (1.1 cr standard, 2.1 cr pro, 2.1 cr ultra); a failed generation is refunded automatically. Earlier versions of this endpoint, if any, keep being served under their own names.

Parameter	Value for this workflow
workflow	"voice_over-v1" required
prompt	Describe the creation or the change — English works best.
ratio	9:16 · 1:1 · 3:4 · 2:3 · 4:3 · 3:2
tier	"standard" (1.1 cr), "pro" (2.1 cr) or "ultra" (2.1 cr) — a 4K picture, from the Pro plan
webhook_url	Optional — we POST the outcome here when the generation settles. Without it, poll the URL returned in the response until the status settles.

Example request

curl -X POST https://thenewblack.ai/api/v1/generate \
  -H "Authorization: Bearer tnb_live_XXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow": "voice_over-v1",
    "prompt": "Describe the creation or the change",
    "ratio": "9:16",
    "tier": "standard"
  }'

// 202 Accepted
{
  "generation_id": "3f1c9a6e-...",
  "status": "running",
  "poll": "/api/v1/generations/3f1c9a6e-..."
}

Example response

Poll /v1/generations/{id} (or receive the webhook) until the generation settles:

// 200 OK
{
  "generation_id": "3f1c9a6e-...",
  "workflow": "voice_over",
  "status": "succeeded",
  "result": {
    "type": "image",
    "url": "https://.../result.webp",
    "thumbnail": "https://.../thumb.webp"
  }
}

Results are stored for 48 hours — copy them to your own storage. Authentication, errors and webhooks are documented in the full API reference.

Frequently asked questions

What does the Create a Voice-over endpoint need?

a prompt — all as listed in the parameter table above, and in GET /v1/catalog.

How is it billed?

Per generation, at the standard, pro or ultra price shown above; a failed generation is refunded.

How much does it cost?

1.1 credits on the standard tier, 2.1 on pro, 2.1 on ultra. Credits come with plans and packs; a failed generation is always refunded.

Other endpoints: Virtual Try-On API · AI Fashion Models API · Fashion Design API · Reimagine Model API · Swap Model API · AI Stylist API · all endpoints