narrador files

Upload and start an audio job

One-step narrador files flow: send a document as multipart (file field), JSON url, or JSON text. Creates the storage object and starts the same job as POST /v1/files/jobs. Poll GET /v1/files/jobs/{jobId} and GET /v1/files/jobs/{jobId}/result. Requires a nrd_files_ key.

post/v1/files/generate

Request

  • Base URL: https://api.narrador.io
  • URL: https://api.narrador.io/v1/files/generate
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Request body

urlstring uri

Public http(s) URL to fetch server-side (max 50 MB).

textstring
fileNamestring
voiceIdstring uuid
accent'af-za' | 'am-et' | 'ar-ae' | 'ar-eg' | 'ar-iq' | 'ar-kw' | 'ar-ma' | 'ar-qa' | 'ar-sa' | 'az-az' | 'bn-bd' | 'bn-in' | 'cmn-cn' | 'ja-jp' | 'jv-id' | 'kk-kz' | 'km-kh' | 'ko-kr' | 'mn-mn' | 'my-mm' | 'ne-np' | 'ps-af' | 'si-lk' | 'so-so' | 'th-th' | 'vi-vn' | 'zh-cn' | 'zh-hk' | 'zh-tw' | 'yue-cn' | 'bg-bg' | 'bs-ba' | 'ca-es' | 'cs-cz' | 'da-dk' | 'de-de' | 'el-gr' | 'et-ee' | 'eu-es' | 'fi-fi' | 'fr-be' | 'fr-ca' | 'fr-ch' | 'fr-fr' | 'ga-ie' | 'hr-hr' | 'hu-hu' | 'hy-am' | 'is-is' | 'it-it' | 'lt-lt' | 'lv-lv' | 'nb-no' | 'nl-be' | 'nl-nl' | 'pl-pl' | 'pt-br' | 'pt-pt' | 'ro-ro' | 'ru-ru' | 'sk-sk' | 'sl-si' | 'sq-al' | 'sr-rs' | 'sv-se' | 'tr-tr' | 'uk-ua' | 'en-au' | 'en-ca' | 'en-gb' | 'en-hk' | 'en-ie' | 'en-in' | 'en-ke' | 'en-nz' | 'en-sg' | 'en-us' | 'en-za' | 'es-ar' | 'es-cl' | 'es-co' | 'es-cr' | 'es-cu' | 'es-do' | 'es-ec' | 'es-es' | 'es-mx' | 'es-pe' | 'es-pr' | 'es-py' | 'es-us' | 'es-ve' | 'gu-in' | 'hi-in' | 'kn-in' | 'ml-in' | 'mr-in' | 'pa-in' | 'ta-in' | 'ta-lk' | 'ta-my' | 'te-in' | 'fa-ir' | 'fil-ph' | 'he-il' | 'id-id' | 'ms-my' | 'mt-mt' | 'sw-ke' | 'ur-pk' | 'zu-za'
callbackUrlstring uri

Optional https URL on a public host for a single terminal job webhook (see Files job webhooks).

Response

Job created

jobIdstring uuid
projectIdstring uuid
status'idle' | 'processing' | 'processed' | 'failed_file_processing' | 'generating' | 'failed_audio_generation' | 'completed'

Changes

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