{"openapi":"3.1.0","info":{"title":"NeuroDynamic audio and LLM APIs: narration, transcription, voice cloning and text generation","description":"Pay-per-use audio and LLM APIs for agents: text-to-speech narration, speech-to-text transcription, consent-reviewed voice cloning and uncensored text generation. Read the linked service instructions, privacy terms and retention limits before sending content.","version":"1.0.0","contact":{"name":"NeuroDynamic API support","email":"support@neurodynamic.tech","url":"https://neurodynamic.tech/contact"},"termsOfService":"https://neurodynamic.tech/terms","x-guidance":"Convert text to speech, transcribe audio, clone an approved private voice, or generate LLM text. Choose by price and limits; read the service guide and obtain a free 402 quote before authorising payment."},"paths":{"/":{"get":{"summary":"Index","operationId":"index__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/pricing":{"get":{"summary":"Pricing","operationId":"pricing_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/audio/transcriptions":{"post":{"summary":"Transcribe a short audio clip","operationId":"transcribe_v1_audio_transcriptions_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded settlement receipt.","schema":{"type":"string"}}}},"402":{"description":"Payment required or invalid","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 quote. No charge.","schema":{"type":"string"}}}},"409":{"description":"Conflicting or uncertain payment; do not pay again"},"413":{"description":"Upload too large"},"422":{"description":"Invalid audio or fields"},"503":{"description":"Busy or dependency unavailable"}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"additionalProperties":false,"properties":{"file":{"type":"string","format":"binary"},"model":{"type":"string","enum":["whisper-1"],"default":"whisper-1"},"language":{"type":"string","pattern":"^[a-z]{2}$"},"response_format":{"type":"string","enum":["json"],"default":"json"}}}}}},"parameters":[{"in":"header","name":"PAYMENT-SIGNATURE","required":false,"schema":{"type":"string"},"description":"Omit for a free 402 quote. Supply a locally signed x402 v2 payment authorisation to buy the result. No account or API key is required."}],"description":"WAV, MP3, FLAC or Ogg, up to 60 seconds and 12 MiB. Returns JSON text; no separate account required. Read /pricing for billing and retry rules.","x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01","currency":"USD","network":"eip155:8453","asset":"USDC","description":"Introductory pricing. 0.01 USDC on Base; validate the runtime quote before signing."},"security":[],"externalDocs":{"description":"Read before obtaining a quote or paying","url":"https://api.neurodynamic.tech/pricing"}}},"/v1/audio/cloning/capabilities":{"get":{"summary":"Discovery","operationId":"discovery_v1_audio_cloning_capabilities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/audio/jobs":{"post":{"summary":"Submit","operationId":"submit_v1_audio_jobs_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"idempotency-key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Submission"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audio/jobs/{job}":{"get":{"summary":"Status","operationId":"status_v1_audio_jobs__job__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job","in":"path","required":true,"schema":{"title":"Job"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Cancel","operationId":"cancel_v1_audio_jobs__job__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job","in":"path","required":true,"schema":{"title":"Job"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audio/jobs/{job}/result":{"get":{"summary":"Result","operationId":"result_v1_audio_jobs__job__result_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job","in":"path","required":true,"schema":{"title":"Job"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/voices":{"post":{"summary":"Enrol","operationId":"enrol_v1_voices_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"idempotency-key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Enrolment"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/voices/{voice}":{"get":{"summary":"Voice Status","operationId":"voice_status_v1_voices__voice__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"voice","in":"path","required":true,"schema":{"title":"Voice"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Delete Voice","operationId":"delete_voice_v1_voices__voice__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"voice","in":"path","required":true,"schema":{"title":"Voice"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audio/cloning/result":{"post":{"summary":"Collect an approved private-voice WAV","operationId":"collect_v1_audio_cloning_result_post","responses":{"200":{"description":"Purchased WAV and PAYMENT-RESPONSE receipt","content":{"audio/wav":{"schema":{"type":"string","format":"binary"}}},"headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded settlement receipt.","schema":{"type":"string"}}}},"202":{"description":"Still queued/running; no payment required"},"402":{"description":"x402 challenge; PAYMENT-REQUIRED header","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 quote. No charge.","schema":{"type":"string"}}}},"409":{"description":"Conflict or uncertain payment; do not pay again"},"410":{"description":"Result expired or deleted; do not pay again"},"401":{"description":"Requester authentication required"},"503":{"description":"Unavailable; respect Retry-After"}},"description":"Requires an approved account, reviewed private voice and ready job. First read /cloning. Submit and poll without payment; pay only when ready. Short: 1,000 characters for 0.01 USDC. Long: up to 2,000 words AND 12,000 characters for 0.05 USDC. English joined WAV; similarity and accent vary.","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"job_id":{"pattern":"^job_[0-9a-f]{32}$","title":"Job Id","type":"string"}},"required":["job_id"],"title":"CollectBody","type":"object"}}}},"parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"Sign only for a ready job; retain exact proof for retry"}],"security":[{"X402Payment":[],"HTTPBearer":[]}],"x-payment-info":{"protocols":["x402"],"pricingMode":"tiered","price":"0.01","currency":"USD","network":"eip155:8453","asset":"USDC","description":"Introductory pricing. Short 0.01 or long 0.05 USDC, selected when submitting; validate the runtime quote before signing.","tiers":{"short":"0.01","long":"0.05"}},"externalDocs":{"description":"Read before obtaining a quote or paying","url":"https://api.neurodynamic.tech/cloning"}}},"/v1/audio/voices":{"get":{"summary":"Free measured voice catalogue","operationId":"voices_v1_audio_voices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/audio/voices/{voice_id}/sample":{"get":{"summary":"Free synthetic voice sample","operationId":"sample_v1_audio_voices__voice_id__sample_get","parameters":[{"name":"voice_id","in":"path","required":true,"schema":{"type":"string","title":"Voice Id"}}],"responses":{"200":{"description":"Successful Response","content":{"audio/mpeg":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audio/narration/client.py":{"get":{"summary":"Client","operationId":"client_v1_audio_narration_client_py_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/v1/audio/narration/capabilities":{"get":{"summary":"Capabilities","operationId":"capabilities_v1_audio_narration_capabilities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/audio/narration/openapi.json":{"get":{"summary":"Schema","operationId":"schema_v1_audio_narration_openapi_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/audio/speech":{"post":{"summary":"Generate MP3 narration with a catalogue voice","operationId":"transcribe_v1_audio_speech_post","requestBody":{"content":{"application/json":{"schema":{"properties":{"input":{"type":"string","maxLength":1000,"minLength":1},"voice":{"type":"string","enum":["af_heart","af_bella","bf_emma","bf_alice","bm_george","am_michael","am_fenrir"]},"model":{"enum":["kokoro"]},"response_format":{"enum":["mp3"]},"speed":{"enum":[1]},"stream":{"enum":[false]}},"additionalProperties":false,"type":"object","required":["input"]}}},"required":true},"responses":{"200":{"description":"MP3 and PAYMENT-RESPONSE receipt","content":{"audio/mpeg":{"schema":{"type":"string","format":"binary"}}},"headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded settlement receipt.","schema":{"type":"string"}}}},"402":{"description":"Free x402 quote","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 quote. No charge.","schema":{"type":"string"}}}},"409":{"description":"Payment conflict or uncertainty: do not pay again"},"503":{"description":"Busy: retry same proof"}},"description":"Introductory pricing: 0.005 USDC for one MP3 up to 1,000 input characters. Seven catalogue voices; no account or voice approval. Read https://api.neurodynamic.tech/narration for request format and payment recovery.","x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.005","currency":"USD","network":"eip155:8453","asset":"USDC","description":"Introductory pricing. 0.005 USDC on Base; validate the runtime quote before signing."},"security":[],"externalDocs":{"description":"Read before obtaining a quote or paying","url":"https://api.neurodynamic.tech/narration"},"parameters":[{"in":"header","name":"PAYMENT-SIGNATURE","required":false,"schema":{"type":"string"},"description":"Omit for a free 402 quote. Supply a locally signed x402 v2 payment authorisation to buy the result. No account or API key is required."}]}},"/v1/llm/abliterated/completions":{"post":{"summary":"Abliterated Model — uncensored LLM text generation","operationId":"Generate_abliterated_v1_llm_abliterated_completions_post","requestBody":{"content":{"application/json":{"schema":{"properties":{"input":{"type":"string","maxLength":2000,"description":"At most 2000 UTF-8 bytes"},"max_tokens":{"type":"integer","maximum":512.0,"minimum":16.0,"default":512},"terms_version":{"const":"2026-09-11-llm-v1"},"adult":{"const":true},"third_party_processing":{"const":true}},"additionalProperties":false,"type":"object","required":["input","terms_version","adult","third_party_processing"]}}},"required":true},"responses":{"200":{"description":"Generated text and payment receipt","content":{"application/json":{"schema":{"type":"object","required":["object","model","text","finish_reason","ai_generated","request_id","usage"],"properties":{"object":{"const":"text_completion"},"model":{"const":"abliterated"},"text":{"type":"string"},"finish_reason":{"enum":["stop","length"]},"ai_generated":{"const":true},"request_id":{"type":"string"},"usage":{"type":"object","required":["prompt_tokens","completion_tokens"],"properties":{"prompt_tokens":{"type":"integer","minimum":0},"completion_tokens":{"type":"integer","minimum":0}}}}}}},"headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded settlement receipt.","schema":{"type":"string"}}}},"402":{"description":"Free x402 quote","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 quote. No charge.","schema":{"type":"string"}}}},"409":{"description":"Uncertain or previously used proof; check status"},"410":{"description":"Already settled; output not retained"},"503":{"description":"Unavailable; no new settlement attempted"}},"description":"Introductory pricing. 0.020 USDC per request; 2000 UTF-8 input bytes and up to 512 output tokens. Adults 18+, lawful use. No local prompt/answer retention after processing; third-party policies and metadata retention apply separately. Read https://api.neurodynamic.tech/llm. Lost output cannot be replayed; check payment status using the saved proof.","security":[],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.020","currency":"USD","network":"eip155:8453","asset":"USDC","description":"Introductory pricing. 0.020 USDC on Base; validate the runtime quote before signing."},"externalDocs":{"description":"Read before obtaining a quote or paying","url":"https://api.neurodynamic.tech/llm"},"parameters":[{"in":"header","name":"PAYMENT-SIGNATURE","required":false,"schema":{"type":"string"},"description":"Omit for a free 402 quote. Supply a locally signed x402 v2 payment authorisation to buy the result. No account or API key is required."}]}},"/v1/llm/abliterated-large/completions":{"post":{"summary":"Abliterated Model Large — uncensored LLM text generation","operationId":"Generate_abliterated_large_v1_llm_abliterated_large_completions_post","requestBody":{"content":{"application/json":{"schema":{"properties":{"input":{"type":"string","maxLength":2000,"description":"At most 2000 UTF-8 bytes"},"max_tokens":{"type":"integer","maximum":512.0,"minimum":16.0,"default":512},"terms_version":{"const":"2026-09-11-llm-v1"},"adult":{"const":true},"third_party_processing":{"const":true}},"additionalProperties":false,"type":"object","required":["input","terms_version","adult","third_party_processing"]}}},"required":true},"responses":{"200":{"description":"Generated text and payment receipt","content":{"application/json":{"schema":{"type":"object","required":["object","model","text","finish_reason","ai_generated","request_id","usage"],"properties":{"object":{"const":"text_completion"},"model":{"const":"abliterated-large"},"text":{"type":"string"},"finish_reason":{"enum":["stop","length"]},"ai_generated":{"const":true},"request_id":{"type":"string"},"usage":{"type":"object","required":["prompt_tokens","completion_tokens"],"properties":{"prompt_tokens":{"type":"integer","minimum":0},"completion_tokens":{"type":"integer","minimum":0}}}}}}},"headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded settlement receipt.","schema":{"type":"string"}}}},"402":{"description":"Free x402 quote","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 quote. No charge.","schema":{"type":"string"}}}},"409":{"description":"Uncertain or previously used proof; check status"},"410":{"description":"Already settled; output not retained"},"503":{"description":"Unavailable; no new settlement attempted"}},"description":"Introductory pricing. 0.035 USDC per request; 2000 UTF-8 input bytes and up to 512 output tokens. Adults 18+, lawful use. No local prompt/answer retention after processing; third-party policies and metadata retention apply separately. Read https://api.neurodynamic.tech/llm. Lost output cannot be replayed; check payment status using the saved proof.","security":[],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.035","currency":"USD","network":"eip155:8453","asset":"USDC","description":"Introductory pricing. 0.035 USDC on Base; validate the runtime quote before signing."},"externalDocs":{"description":"Read before obtaining a quote or paying","url":"https://api.neurodynamic.tech/llm"},"parameters":[{"in":"header","name":"PAYMENT-SIGNATURE","required":false,"schema":{"type":"string"},"description":"Omit for a free 402 quote. Supply a locally signed x402 v2 payment authorisation to buy the result. No account or API key is required."}]}}},"components":{"schemas":{"Authorization":{"properties":{"basis":{"type":"string","enum":["own_voice","licensed_voice","synthetic_voice"],"title":"Basis"},"speaker_permission":{"type":"boolean","title":"Speaker Permission"},"recording_rights":{"type":"boolean","title":"Recording Rights"},"no_deceptive_use":{"type":"boolean","title":"No Deceptive Use"},"terms_version":{"type":"string","title":"Terms Version"},"evidence_reference":{"type":"string","maxLength":1000,"minLength":12,"title":"Evidence Reference"}},"additionalProperties":false,"type":"object","required":["basis","speaker_permission","recording_rights","no_deceptive_use","terms_version","evidence_reference"],"title":"Authorization"},"Enrolment":{"properties":{"name":{"type":"string","maxLength":80,"minLength":1,"title":"Name"},"sample_wav_base64":{"type":"string","maxLength":1400000,"title":"Sample Wav Base64"},"authorization":{"$ref":"#/components/schemas/Authorization"}},"additionalProperties":false,"type":"object","required":["name","sample_wav_base64","authorization"],"title":"Enrolment"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Submission":{"properties":{"voice_id":{"anyOf":[{"type":"string","pattern":"^voice_[0-9a-f]{32}$"},{"type":"null"}],"title":"Voice Id"},"tier":{"type":"string","enum":["short","long"],"title":"Tier","default":"short"},"text":{"type":"string","maxLength":12000,"minLength":1,"title":"Text"},"exaggeration":{"type":"number","maximum":0.7,"minimum":0.3,"title":"Exaggeration","default":0.3}},"additionalProperties":false,"type":"object","required":["voice_id","text"],"title":"Submission"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"},"X402Payment":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"Obtain a free 402 quote before signing locally. Required for a purchase, not for an unpaid quote. Keep the original proof for recovery."}}},"externalDocs":{"description":"Request formats, prices, limits, privacy and payment recovery","url":"https://api.neurodynamic.tech/llms.txt"},"servers":[{"url":"https://api.neurodynamic.tech"}],"x-discovery":{"instructions":"https://api.neurodynamic.tech/llms.txt"}}