Voice

Hear voice samples of a variant

Designs three voices from a description, each reading the same line. Costs 1 credit for the three. Keep one with PUT /v1/mascots/{id}/variants/{variantId}/voice within 24 hours.

post/v1/mascots/{id}/variants/{variantId}/voice/samples

Request

  • Base URL: https://api.masko.ai
  • URL: https://api.masko.ai/v1/mascots/{id}/variants/{variantId}/voice/samples
  • Auth: HTTP bearer

Path parameters

idstring uuid required
variantIdstring uuid required

Headers

Idempotency-Keystring

Account-scoped key (1 to 255 characters, ideally a UUID). Retries must preserve the credential workspace, effective API version, URL, content type and exact body bytes, including multipart boundaries; different inputs return 409 idempotency_key_reused. Completed responses, including 500 errors, replay for 24 hours after completion with current resource access checked again. Running or unconfirmed executions return 409 idempotency_request_in_progress and do not expire automatically. A receipt persistence failure returns 503 idempotency_persistence_failed: retry only with the same key and inspect the operation outcome before starting a new request.

Request body

descriptionstring required

How the voice sounds: age, pitch, pace, energy, texture, mood and accent.

sample_linestring

The line the samples read. Lines shorter than 100 characters are extended. Omit it for a line in the mascot's name.

Response

Three samples

Changes

No recorded changes to this operation across all 1 revision of this API.