{
"error": {
"type": "invalid_api_key",
"message": "The provided API key is invalid. Please ensure your API key is correct and active. You can find more information about obtaining a key on our website: https://naga.ac If you just created this key, wait a few minutes and try again."
}
}
{
"error": {
"type": "insufficient_quota",
"message": "More credits required to process this request. Visit https://naga.ac/dashboard/credits to add credits."
}
}
{
"error": {
"type": "rate_limit_exceeded",
"message": "Free model limit reached (100 requests per day and 10 per minute). Try again in 3s, or add credits at https://naga.ac/dashboard/credits to use paid models, which have no request limit."
}
}
Converts uploaded audio into text in the language that was spoken and charges the account for what it counted. Requires an API key. /v1/audio/translations answers in English instead.
POST
https://api.naga.ac
/
v1
/
audio
/
transcriptions
openai-python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["NAGA_API_KEY"],
base_url="https://api.naga.ac/v1",
)
result = client.audio.transcriptions.create(
model="elevenlabs/scribe-v2",
file=open("audio.mp3", "rb"),
)
print(result)
import fs from "node:fs";
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.NAGA_API_KEY,
baseURL: "https://api.naga.ac/v1",
});
const result = await client.audio.transcriptions.create({
model: "elevenlabs/scribe-v2",
file: fs.createReadStream("audio.mp3"),
});
console.log(result);
{
"error": {
"type": "invalid_api_key",
"message": "The provided API key is invalid. Please ensure your API key is correct and active. You can find more information about obtaining a key on our website: https://naga.ac If you just created this key, wait a few minutes and try again."
}
}
{
"error": {
"type": "insufficient_quota",
"message": "More credits required to process this request. Visit https://naga.ac/dashboard/credits to add credits."
}
}
{
"error": {
"type": "rate_limit_exceeded",
"message": "Free model limit reached (100 requests per day and 10 per minute). Try again in 3s, or add credits at https://naga.ac/dashboard/credits to use paid models, which have no request limit."
}
}
An account API key. Send it as Authorization: Bearer <key>.
Body
multipart/form-data
The audio to transcribe, as the part named file, beside the model to transcribe with and two optional hints.
The multipart/form-data body of POST /v1/audio/transcriptions and of POST /v1/audio/translations — one audio upload and three text fields.
model
string
required
The model to transcribe or translate with, named by its id or alias.
file
file
required
The audio file itself. The gateway converts the container where the provider needs another.
models
string[]
Fallback models, tried in order when model cannot answer: none of its providers served it. At most 3, and only the model that answered is billed. A NagaAI extension in OpenRouter's shape.
Maximum array length: 3
routing
object
How NagaAI picks the providers for this request: max_price removes the dearer ones and can fail the request. Takes no strategy. In a form, send each cap as its own part named by its path, routing[max_price][<meter>], or the whole object as JSON in one routing part. A NagaAI extension.
Hide child attributes
routing.max_price
object
The most one unit of each named meter may cost. Absent: no price limit.
Hide child attributes
routing.max_price.token
stringnumber
Credits per token, either direction, without a meter of its own. A non-negative decimal, as a string or a number.
routing.max_price.input_token
stringnumber
Credits per prompt token without a meter of its own. A non-negative decimal, as a string or a number.
routing.max_price.output_token
stringnumber
Credits per output token without a meter of its own. A non-negative decimal, as a string or a number.
routing.max_price.cached_input_token
stringnumber
Credits per prompt token read from cache. A non-negative decimal, as a string or a number.
routing.max_price.cache_write_input_token
stringnumber
Credits per prompt token written to cache. A non-negative decimal, as a string or a number.
routing.max_price.cache_write_1h_input_token
stringnumber
Credits per prompt token cached for one hour. A non-negative decimal, as a string or a number.
routing.max_price.input_text_token
stringnumber
Credits per prompt text token. A non-negative decimal, as a string or a number.
routing.max_price.output_text_token
stringnumber
Credits per output text token. A non-negative decimal, as a string or a number.
routing.max_price.input_audio_token
stringnumber
Credits per input audio token. A non-negative decimal, as a string or a number.
routing.max_price.output_audio_token
stringnumber
Credits per output audio token. A non-negative decimal, as a string or a number.
routing.max_price.input_image_token
stringnumber
Credits per input image token. A non-negative decimal, as a string or a number.
routing.max_price.output_image_token
stringnumber
Credits per output image token. A non-negative decimal, as a string or a number.
routing.max_price.input_audio_hour
stringnumber
Credits per hour of input audio. A non-negative decimal, as a string or a number.
routing.max_price.output_audio_hour
stringnumber
Credits per hour of output audio. A non-negative decimal, as a string or a number.
routing.max_price.input_text_character
stringnumber
Credits per input text character. A non-negative decimal, as a string or a number.
routing.max_price.output_text_character
stringnumber
Credits per output text character. A non-negative decimal, as a string or a number.
routing.max_price.input_text_search
stringnumber
Credits per rerank search. A non-negative decimal, as a string or a number.
routing.max_price.output_image_image
stringnumber
Credits per delivered picture. A non-negative decimal, as a string or a number.
routing.max_price.request
stringnumber
Credits per request: the fee a request pays once. A non-negative decimal, as a string or a number.
routing.max_price.output_video_second
stringnumber
Credits per second of video. A non-negative decimal, as a string or a number.
routing.max_price.output_video_megapixel_second
stringnumber
Credits per megapixel-second of upscaled video. A non-negative decimal, as a string or a number.
Example:
{ "output_token": "0.000005" }
routing.precision
enum<string>[]
The weight precisions the model may be served in. Absent: any.
Minimum array length: 1
A weight precision a provider serves a model in, as it publishes it.
Available options:
int4,
int8,
fp4,
mxfp4,
nvfp4,
fp6,
fp8,
mxfp8,
fp16,
bf16,
fp32
prompt
string | null
A free-form hint for the provider: names, jargon, expected style.
language
string | null
The language spoken in the audio, as a lower-case ISO 639-1 code. Any other shape draws a 400.
stream
boolean
true answers with server-sent events instead of one JSON body: a transcript.text.delta with the whole text, then transcript.text.done, once the provider has answered. false or absent answers JSON; any other value draws a 400.
Response
The transcript, as one object with one key. With stream, text/event-stream carries it as transcript.text.delta, then transcript.text.done.
The answer both audio-to-text routes give: the recognized text.
text
string
required
What the model heard in the uploaded audio, and the whole body.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"NagaAI Documentation","colors":{"primary":"#5a5ae5","light":"#8893fa","dark":"#5351da"},"logo":{"light":"https://mintcdn.com/nagaai-60f8697b/3Tc2Ajidq18FPFoC/static/img/logo-light.svg?fit=max\u0026auto=format\u0026n=3Tc2Ajidq18FPFoC\u0026q=85\u0026s=18d579338bd90baa596e41e2e2322393","dark":"https://mintcdn.com/nagaai-60f8697b/3Tc2Ajidq18FPFoC/static/img/logo-dark.svg?fit=max\u0026auto=format\u0026n=3Tc2Ajidq18FPFoC\u0026q=85\u0026s=f4927df5611f5a22c6984a3e7b91b6a0"},"favicon":"https://mintcdn.com/nagaai-60f8697b/nbl1KDrtw3_cqedh/static/img/favicon.ico?fit=max\u0026auto=format\u0026n=nbl1KDrtw3_cqedh\u0026q=85\u0026s=a8361945277b5cce4de483745aa5c21c","api":{"params":{"expanded":"all"},"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["python","javascript","curl","go"],"prefill":true},"url":"full"},"appearance":{"default":"system"},"background":{"color":{"light":"#ffffff","dark":"#09090b"}},"navbar":{"links":[{"href":"https://naga.ac/models","label":"Models"},{"href":"https://naga.ac/pricing","label":"Pricing"},{"href":"https://naga.ac/playground","label":"Playground"}],"primary":{"type":"button","label":"Dashboard","href":"https://naga.ac/dashboard"}},"footer":{"socials":{"discord":"https://discord.naga.ac","github":"https://github.com/naga-ai-hub","x":"https://x.com/NagaAIProject","reddit":"https://www.reddit.com/r/NagaAI"},"links":[{"header":"Community","items":[{"label":"Status","href":"https://status.naga.ac"},{"label":"Blog","href":"https://naga.ac/blog"},{"label":"Support","href":"https://discord.naga.ac"}]},{"header":"Resources","items":[{"label":"Models","href":"https://naga.ac/models"},{"label":"Playground","href":"https://naga.ac/playground"},{"label":"Chat","href":"https://chat.naga.ac"}]},{"header":"Legal","items":[{"label":"Privacy","href":"https://naga.ac/legal/privacy"},{"label":"Terms","href":"https://naga.ac/legal/terms"}]}]},"fonts":{"family":"Geist"},"styling":{"codeblocks":{"theme":{"light":"github-light-default","dark":"github-dark-dimmed"}},"latex":true},"contextual":{"options":["copy","view","download-spec","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"nagaai-60f8697b","hasAudioNarration":false,"actualSubdomain":"nagaai-60f8697b","customDomains":["docs.naga.ac"],"gitSource":{"type":"github","owner":"naga-ai-hub","repo":"naga-ai","deployBranch":"master","contentDirectory":"docs-site","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afff8e862a3bc10271d2724","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"default","tag":"Docs","count":35},{"language":"default","tag":"API Reference","count":25},{"language":"default","tag":"Endpoints","count":24},{"language":"default","tag":"Guides","count":17},{"language":"default","tag":"Integrations","count":13},{"language":"default","tag":"Account","count":11},{"language":"default","tag":"Coding agents","count":8},{"language":"default","tag":"How NagaAI works","count":5},{"language":"default","tag":"API Keys","count":5},{"language":"default","tag":"Get started","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[]}
{"page":{"pagePath":"api-reference/audio/create-a-transcription","slug":"/api-reference/audio/create-a-transcription","pageMetadata":{"title":"Create a transcription","description":"Converts uploaded audio into text in the language that was spoken and charges the account for what it counted. Requires an API key. `/v1/audio/translations` answers in English instead.","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json post /v1/audio/transcriptions","href":"/api-reference/audio/create-a-transcription","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Converts uploaded audio into text in the language that was spoken and charges the account for what it counted. Requires an API key. \", _jsx(_components.code, {\n children: \"/v1/audio/translations\"\n }), \" answers in English instead.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light-default","dark":"github-dark-dimmed"}},"config":{},"pageMetadata":{"title":"Create a transcription","description":"Converts uploaded audio into text in the language that was spoken and charges the account for what it counted. Requires an API key. `/v1/audio/translations` answers in English instead.","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json post /v1/audio/transcriptions","href":"/api-reference/audio/create-a-transcription","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Audio"],"summary":"Create a transcription","description":"Converts uploaded audio into text in the language that was spoken and charges the account for what it counted. Requires an API key. `/v1/audio/translations` answers in English instead.","operationId":"create_transcription","externalDocs":{"url":"https://platform.openai.com/docs/api-reference/audio","description":"The OpenAI reference for these routes."},"requestBody":"ae80695b-9060-4a6e-925d-173c0e618b35","responses":{"200":"508c37c3-5198-45f0-96ec-1af439c66741","400":"2b0ecf08-87e2-4b47-ac62-b7c8d48d9bc0","401":"b527bf3b-d7f5-43c5-bb99-fcef786825f1","402":"9f082f75-f787-422e-a2ce-eed10dc4d1fd","403":"d6aae59a-9ace-4df1-b8e1-ed5032574e2a","408":"77e38a0b-891e-4e38-8df5-0b4111c9eb43","410":"3a8ef3f6-1462-4629-b9c4-df274717df00","413":"e548a4a3-cd36-4177-8e5a-3484861480ed","422":"3c195f79-eaf7-414e-8059-a2c137c69305","429":"9e7fe514-55f6-4933-a789-1e5816d0c566","500":"cf63755a-d5ef-4f9c-b98d-11bd49702810","503":"2142ebfb-a75a-4765-aefa-004c7151cfb5"},"security":["26d809cb-6363-40ed-b33e-0635e21a4579","8ebc2ea0-3893-494f-907a-a8c04041f58f"],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl https://api.naga.ac/v1/audio/transcriptions \\\n -H \"Authorization: Bearer $NAGA_API_KEY\" \\\n -F 'model=elevenlabs/scribe-v2' \\\n -F 'file=@audio.mp3'"},{"lang":"python","label":"openai-python","source":"import os\nfrom openai import OpenAI\n\nclient = OpenAI(\n api_key=os.environ[\"NAGA_API_KEY\"],\n base_url=\"https://api.naga.ac/v1\",\n)\n\nresult = client.audio.transcriptions.create(\n model=\"elevenlabs/scribe-v2\",\n file=open(\"audio.mp3\", \"rb\"),\n)\nprint(result)\n"},{"lang":"javascript","label":"openai-node","source":"import fs from \"node:fs\";\nimport OpenAI from \"openai\";\n\nconst client = new OpenAI({\n apiKey: process.env.NAGA_API_KEY,\n baseURL: \"https://api.naga.ac/v1\",\n});\n\nconst result = await client.audio.transcriptions.create({\n model: \"elevenlabs/scribe-v2\",\n file: fs.createReadStream(\"audio.mp3\"),\n});\nconsole.log(result);\n"}],"x-mcp":{"name":"naga_create_transcription","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},"method":"post","type":"path","servers":["ddee1100-762b-4028-ac39-d54cdb9aa21e"],"path":"/v1/audio/transcriptions","baseUrlOptions":["https://api.naga.ac"],"title":"Create a transcription","codeSamples":[{"label":"curl","lang":"bash","source":"curl https://api.naga.ac/v1/audio/transcriptions \\\n -H \"Authorization: Bearer $NAGA_API_KEY\" \\\n -F 'model=elevenlabs/scribe-v2' \\\n -F 'file=@audio.mp3'"},{"label":"openai-python","lang":"python","source":"import os\nfrom openai import OpenAI\n\nclient = OpenAI(\n api_key=os.environ[\"NAGA_API_KEY\"],\n base_url=\"https://api.naga.ac/v1\",\n)\n\nresult = client.audio.transcriptions.create(\n model=\"elevenlabs/scribe-v2\",\n file=open(\"audio.mp3\", \"rb\"),\n)\nprint(result)\n"},{"label":"openai-node","lang":"javascript","source":"import fs from \"node:fs\";\nimport OpenAI from \"openai\";\n\nconst client = new OpenAI({\n apiKey: process.env.NAGA_API_KEY,\n baseURL: \"https://api.naga.ac/v1\",\n});\n\nconst result = await client.audio.transcriptions.create({\n model: \"elevenlabs/scribe-v2\",\n file: fs.createReadStream(\"audio.mp3\"),\n});\nconsole.log(result);\n"}],"requestExampleLanguages":["python","javascript","bash","go"],"requiredOnlyExamples":true,"requestExampleType":"codeSamples","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.model":"elevenlabs/scribe-v2","body.file":"audio.mp3"}],"urlDisplay":"full"},"dependencies":{"parameters":{},"requestBody":{"description":"The audio to transcribe, as the part named `file`, beside the model to transcribe with and two optional hints.","content":{"multipart/form-data":{"schema":{"type":"object","description":"The `multipart/form-data` body of `POST /v1/audio/transcriptions` and of `POST /v1/audio/translations` — one audio upload and three text fields.","required":["model","file"],"properties":{"model":{"type":"string","description":"The model to transcribe or translate with, named by its id or alias.","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"file":{"type":"string","description":"The audio file itself. The gateway converts the container where the provider needs another.","contentMediaType":"application/octet-stream","isRequired":true,"uniqueKey":"file","typeLabel":"file"},"models":{"type":"array","items":{"type":"string","uniqueKey":"models.items.[INDEX]","typeLabel":"string"},"description":"Fallback models, tried in order when `model` cannot answer: none of its providers served it. At most 3, and only the model that answered is billed. A NagaAI extension in OpenRouter's shape.","maxItems":3,"uniqueKey":"models","typeLabel":"string[]"},"routing":{"type":"object","description":"How NagaAI picks the providers for this request: `max_price` removes the dearer ones and can fail the request. Takes no `strategy`. In a form, send each cap as its own part named by its path, `routing[max_price][\u003cmeter>]`, or the whole object as JSON in one `routing` part. A NagaAI extension.","properties":{"max_price":{"type":"object","description":"The most one unit of each named meter may cost. Absent: no price limit.","example":{"output_token":"0.000005"},"properties":{"token":{"oneOf":[{"type":"string","description":"Credits per token, either direction, without a meter of its own. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.token.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per token, either direction, without a meter of its own. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.token.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.token","typeLabel":"string | number"},"input_token":{"oneOf":[{"type":"string","description":"Credits per prompt token without a meter of its own. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.input_token.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per prompt token without a meter of its own. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.input_token.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.input_token","typeLabel":"string | number"},"output_token":{"oneOf":[{"type":"string","description":"Credits per output token without a meter of its own. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.output_token.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per output token without a meter of its own. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.output_token.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.output_token","typeLabel":"string | number"},"cached_input_token":{"oneOf":[{"type":"string","description":"Credits per prompt token read from cache. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.cached_input_token.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per prompt token read from cache. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.cached_input_token.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.cached_input_token","typeLabel":"string | number"},"cache_write_input_token":{"oneOf":[{"type":"string","description":"Credits per prompt token written to cache. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.cache_write_input_token.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per prompt token written to cache. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.cache_write_input_token.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.cache_write_input_token","typeLabel":"string | number"},"cache_write_1h_input_token":{"oneOf":[{"type":"string","description":"Credits per prompt token cached for one hour. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.cache_write_1h_input_token.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per prompt token cached for one hour. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.cache_write_1h_input_token.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.cache_write_1h_input_token","typeLabel":"string | number"},"input_text_token":{"oneOf":[{"type":"string","description":"Credits per prompt text token. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.input_text_token.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per prompt text token. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.input_text_token.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.input_text_token","typeLabel":"string | number"},"output_text_token":{"oneOf":[{"type":"string","description":"Credits per output text token. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.output_text_token.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per output text token. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.output_text_token.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.output_text_token","typeLabel":"string | number"},"input_audio_token":{"oneOf":[{"type":"string","description":"Credits per input audio token. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.input_audio_token.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per input audio token. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.input_audio_token.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.input_audio_token","typeLabel":"string | number"},"output_audio_token":{"oneOf":[{"type":"string","description":"Credits per output audio token. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.output_audio_token.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per output audio token. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.output_audio_token.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.output_audio_token","typeLabel":"string | number"},"input_image_token":{"oneOf":[{"type":"string","description":"Credits per input image token. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.input_image_token.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per input image token. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.input_image_token.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.input_image_token","typeLabel":"string | number"},"output_image_token":{"oneOf":[{"type":"string","description":"Credits per output image token. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.output_image_token.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per output image token. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.output_image_token.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.output_image_token","typeLabel":"string | number"},"input_audio_hour":{"oneOf":[{"type":"string","description":"Credits per hour of input audio. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.input_audio_hour.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per hour of input audio. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.input_audio_hour.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.input_audio_hour","typeLabel":"string | number"},"output_audio_hour":{"oneOf":[{"type":"string","description":"Credits per hour of output audio. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.output_audio_hour.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per hour of output audio. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.output_audio_hour.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.output_audio_hour","typeLabel":"string | number"},"input_text_character":{"oneOf":[{"type":"string","description":"Credits per input text character. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.input_text_character.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per input text character. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.input_text_character.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.input_text_character","typeLabel":"string | number"},"output_text_character":{"oneOf":[{"type":"string","description":"Credits per output text character. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.output_text_character.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per output text character. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.output_text_character.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.output_text_character","typeLabel":"string | number"},"input_text_search":{"oneOf":[{"type":"string","description":"Credits per rerank search. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.input_text_search.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per rerank search. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.input_text_search.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.input_text_search","typeLabel":"string | number"},"output_image_image":{"oneOf":[{"type":"string","description":"Credits per delivered picture. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.output_image_image.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per delivered picture. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.output_image_image.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.output_image_image","typeLabel":"string | number"},"request":{"oneOf":[{"type":"string","description":"Credits per request: the fee a request pays once. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.request.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per request: the fee a request pays once. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.request.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.request","typeLabel":"string | number"},"output_video_second":{"oneOf":[{"type":"string","description":"Credits per second of video. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.output_video_second.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per second of video. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.output_video_second.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.output_video_second","typeLabel":"string | number"},"output_video_megapixel_second":{"oneOf":[{"type":"string","description":"Credits per megapixel-second of upscaled video. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.output_video_megapixel_second.oneOf.0","typeLabel":"string"},{"type":"number","description":"Credits per megapixel-second of upscaled video. A non-negative decimal, as a string or a number.","minimum":0,"uniqueKey":"routing.max_price.output_video_megapixel_second.oneOf.1","typeLabel":"number"}],"uniqueKey":"routing.max_price.output_video_megapixel_second","typeLabel":"string | number"}},"additionalProperties":false,"uniqueKey":"routing.max_price","typeLabel":"object"},"precision":{"type":"array","items":{"type":"string","description":"A weight precision a provider serves a model in, as it publishes it.","enum":["int4","int8","fp4","mxfp4","nvfp4","fp6","fp8","mxfp8","fp16","bf16","fp32"],"uniqueKey":"routing.precision.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"The weight precisions the model may be served in. Absent: any.","minItems":1,"uniqueKey":"routing.precision","typeLabel":"enum\u003cstring>[]"}},"additionalProperties":false,"uniqueKey":"routing","typeLabel":"object"},"prompt":{"oneOf":[{"type":"string","description":"A free-form hint for the provider: names, jargon, expected style.","uniqueKey":"prompt.oneOf.0","typeLabel":"string"},{"type":"null","description":"A free-form hint for the provider: names, jargon, expected style.","uniqueKey":"prompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"prompt","typeLabel":"string | null"},"language":{"oneOf":[{"type":"string","description":"The language spoken in the audio, as a lower-case ISO 639-1 code. Any other shape draws a 400.","uniqueKey":"language.oneOf.0","typeLabel":"string"},{"type":"null","description":"The language spoken in the audio, as a lower-case ISO 639-1 code. Any other shape draws a 400.","uniqueKey":"language.oneOf.1","typeLabel":"null"}],"uniqueKey":"language","typeLabel":"string | null"},"stream":{"type":"boolean","description":"`true` answers with server-sent events instead of one JSON body: a `transcript.text.delta` with the whole text, then `transcript.text.done`, once the provider has answered. `false` or absent answers JSON; any other value draws a 400.","uniqueKey":"stream","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"basic":{"title":"basic","summary":"Transcribe one uploaded file","value":{"model":"elevenlabs/scribe-v2","file":"audio.mp3"}}},"exampleType":"examples"}},"required":true,"exampleType":"examples"},"responses":{"508c37c3-5198-45f0-96ec-1af439c66741":{"description":"The transcript, as one object with one key. With `stream`, `text/event-stream` carries it as `transcript.text.delta`, then `transcript.text.done`.","content":{"application/json":{"schema":{"type":"object","description":"The answer both audio-to-text routes give: the recognized text.","required":["text"],"properties":{"text":{"type":"string","description":"What the model heard in the uploaded audio, and the whole body.","isRequired":true,"uniqueKey":"text","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"basic":{"title":"basic","summary":"What the model heard","value":{"text":"Hello from NagaAI."}}},"exampleType":"examples"},"text/event-stream":{"schema":{"oneOf":[{"type":"object","description":"One event of a streamed `POST /v1/audio/transcriptions`.","required":["delta","type"],"properties":{"delta":{"type":"string","description":"The text added by this event.","isRequired":true,"uniqueKey":"oneOf.0.delta","typeLabel":"string"},"type":{"type":"string","description":"The tag that selects this branch: `type` is `transcript.text.delta`.","enum":["transcript.text.delta"],"isRequired":true,"uniqueKey":"oneOf.0.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"One event of a streamed `POST /v1/audio/transcriptions`.","required":["text","type"],"properties":{"text":{"type":"string","description":"The whole transcript.","isRequired":true,"uniqueKey":"oneOf.1.text","typeLabel":"string"},"type":{"type":"string","description":"The tag that selects this branch: `type` is `transcript.text.done`.","enum":["transcript.text.done"],"isRequired":true,"uniqueKey":"oneOf.1.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"delta":"\u003cstring>","type":"transcript.text.delta"}}},"exampleType":"generated"}},"x-retry-safe":false,"exampleType":"examples"},"2b0ecf08-87e2-4b47-ac62-b7c8d48d9bc0":{"description":"The request is malformed: a field failed its constraint, the body is not valid JSON, the model name is unknown, or no provider serves it within its price limit.","content":{"application/json":{"schema":{"type":"object","description":"`{\"error\": {…}}` — the body of every non-2xx answer outside `/v1/messages`.","required":["error"],"properties":{"error":{"type":"object","description":"The failure itself, and the envelope's only member.","required":["type","message"],"properties":{"type":{"type":"string","description":"The class of the failure; a provider's own class can reach you unchanged.","examples":["invalid_request_error","authentication_required","invalid_api_key","invalid_provisioning_key","invalid_session_token","disabled_api_key","disabled_provisioning_key","expired_api_key","credit_limit_exceeded","rate_limit_exceeded","model_deprecated","inappropriate_content","billing_metering_incomplete","billing_request_id_invalid","billing_writer_missing","server_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","description":"The human-readable sentence shown to the caller.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>"}}}},"exampleType":"generated"}},"x-retry-safe":false,"exampleType":"generated"},"b527bf3b-d7f5-43c5-bb99-fcef786825f1":{"description":"The API key is missing, malformed, disabled, or does not belong to an account that may call this route.","content":{"application/json":{"schema":{"type":"object","description":"`{\"error\": {…}}` — the body of every non-2xx answer outside `/v1/messages`.","required":["error"],"properties":{"error":{"type":"object","description":"The failure itself, and the envelope's only member.","required":["type","message"],"properties":{"type":{"type":"string","description":"The class of the failure; a provider's own class can reach you unchanged.","examples":["invalid_request_error","authentication_required","invalid_api_key","invalid_provisioning_key","invalid_session_token","disabled_api_key","disabled_provisioning_key","expired_api_key","credit_limit_exceeded","rate_limit_exceeded","model_deprecated","inappropriate_content","billing_metering_incomplete","billing_request_id_invalid","billing_writer_missing","server_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","description":"The human-readable sentence shown to the caller.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"invalid-api-key":{"title":"invalid-api-key","summary":"401 — the key is not one this gateway serves","value":{"error":{"type":"invalid_api_key","message":"The provided API key is invalid. Please ensure your API key is correct and active. You can find more information about obtaining a key on our website: https://naga.ac If you just created this key, wait a few minutes and try again."}}}},"exampleType":"examples"}},"x-retry-safe":false,"exampleType":"examples"},"9f082f75-f787-422e-a2ce-eed10dc4d1fd":{"description":"The account has run out of credits. Top up the balance and retry.","content":{"application/json":{"schema":{"type":"object","description":"`{\"error\": {…}}` — the body of every non-2xx answer outside `/v1/messages`.","required":["error"],"properties":{"error":{"type":"object","description":"The failure itself, and the envelope's only member.","required":["type","message"],"properties":{"type":{"type":"string","description":"The class of the failure; a provider's own class can reach you unchanged.","examples":["invalid_request_error","authentication_required","invalid_api_key","invalid_provisioning_key","invalid_session_token","disabled_api_key","disabled_provisioning_key","expired_api_key","credit_limit_exceeded","rate_limit_exceeded","model_deprecated","inappropriate_content","billing_metering_incomplete","billing_request_id_invalid","billing_writer_missing","server_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","description":"The human-readable sentence shown to the caller.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"insufficient-credits":{"title":"insufficient-credits","summary":"402 — the account has no credits left","value":{"error":{"type":"insufficient_quota","message":"More credits required to process this request. Visit https://naga.ac/dashboard/credits to add credits."}}}},"exampleType":"examples"}},"x-retry-safe":false,"exampleType":"examples"},"d6aae59a-9ace-4df1-b8e1-ed5032574e2a":{"description":"The model policy of the organization or of the key's workspace does not allow this model, a spending limit is reached, or the content was blocked by the moderation policy.","content":{"application/json":{"schema":{"type":"object","description":"`{\"error\": {…}}` — the body of every non-2xx answer outside `/v1/messages`.","required":["error"],"properties":{"error":{"type":"object","description":"The failure itself, and the envelope's only member.","required":["type","message"],"properties":{"type":{"type":"string","description":"The class of the failure; a provider's own class can reach you unchanged.","examples":["invalid_request_error","authentication_required","invalid_api_key","invalid_provisioning_key","invalid_session_token","disabled_api_key","disabled_provisioning_key","expired_api_key","credit_limit_exceeded","rate_limit_exceeded","model_deprecated","inappropriate_content","billing_metering_incomplete","billing_request_id_invalid","billing_writer_missing","server_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","description":"The human-readable sentence shown to the caller.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>"}}}},"exampleType":"generated"}},"x-retry-safe":false,"exampleType":"generated"},"77e38a0b-891e-4e38-8df5-0b4111c9eb43":{"description":"The request body did not finish arriving within 15 minutes, or stalled for 60 seconds.","content":{"application/json":{"schema":{"type":"object","description":"`{\"error\": {…}}` — the body of every non-2xx answer outside `/v1/messages`.","required":["error"],"properties":{"error":{"type":"object","description":"The failure itself, and the envelope's only member.","required":["type","message"],"properties":{"type":{"type":"string","description":"The class of the failure; a provider's own class can reach you unchanged.","examples":["invalid_request_error","authentication_required","invalid_api_key","invalid_provisioning_key","invalid_session_token","disabled_api_key","disabled_provisioning_key","expired_api_key","credit_limit_exceeded","rate_limit_exceeded","model_deprecated","inappropriate_content","billing_metering_incomplete","billing_request_id_invalid","billing_writer_missing","server_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","description":"The human-readable sentence shown to the caller.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>"}}}},"exampleType":"generated"}},"x-retry-safe":true,"exampleType":"generated"},"3a8ef3f6-1462-4629-b9c4-df274717df00":{"description":"The model is deprecated and no longer served. Pick a current one.","content":{"application/json":{"schema":{"type":"object","description":"`{\"error\": {…}}` — the body of every non-2xx answer outside `/v1/messages`.","required":["error"],"properties":{"error":{"type":"object","description":"The failure itself, and the envelope's only member.","required":["type","message"],"properties":{"type":{"type":"string","description":"The class of the failure; a provider's own class can reach you unchanged.","examples":["invalid_request_error","authentication_required","invalid_api_key","invalid_provisioning_key","invalid_session_token","disabled_api_key","disabled_provisioning_key","expired_api_key","credit_limit_exceeded","rate_limit_exceeded","model_deprecated","inappropriate_content","billing_metering_incomplete","billing_request_id_invalid","billing_writer_missing","server_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","description":"The human-readable sentence shown to the caller.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>"}}}},"exampleType":"generated"}},"x-retry-safe":false,"exampleType":"generated"},"e548a4a3-cd36-4177-8e5a-3484861480ed":{"description":"The request body is larger than the 32 MiB this gateway accepts.","content":{"application/json":{"schema":{"type":"object","description":"`{\"error\": {…}}` — the body of every non-2xx answer outside `/v1/messages`.","required":["error"],"properties":{"error":{"type":"object","description":"The failure itself, and the envelope's only member.","required":["type","message"],"properties":{"type":{"type":"string","description":"The class of the failure; a provider's own class can reach you unchanged.","examples":["invalid_request_error","authentication_required","invalid_api_key","invalid_provisioning_key","invalid_session_token","disabled_api_key","disabled_provisioning_key","expired_api_key","credit_limit_exceeded","rate_limit_exceeded","model_deprecated","inappropriate_content","billing_metering_incomplete","billing_request_id_invalid","billing_writer_missing","server_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","description":"The human-readable sentence shown to the caller.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>"}}}},"exampleType":"generated"}},"x-retry-safe":false,"exampleType":"generated"},"3c195f79-eaf7-414e-8059-a2c137c69305":{"description":"The request was understood but its usage could not be metered, so it was not served.","content":{"application/json":{"schema":{"type":"object","description":"`{\"error\": {…}}` — the body of every non-2xx answer outside `/v1/messages`.","required":["error"],"properties":{"error":{"type":"object","description":"The failure itself, and the envelope's only member.","required":["type","message"],"properties":{"type":{"type":"string","description":"The class of the failure; a provider's own class can reach you unchanged.","examples":["invalid_request_error","authentication_required","invalid_api_key","invalid_provisioning_key","invalid_session_token","disabled_api_key","disabled_provisioning_key","expired_api_key","credit_limit_exceeded","rate_limit_exceeded","model_deprecated","inappropriate_content","billing_metering_incomplete","billing_request_id_invalid","billing_writer_missing","server_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","description":"The human-readable sentence shown to the caller.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>"}}}},"exampleType":"generated"}},"x-retry-safe":false,"exampleType":"generated"},"9e7fe514-55f6-4933-a789-1e5816d0c566":{"description":"The account exceeded its rate limit. `Retry-After` carries the wait in seconds.","headers":{"Retry-After":{"schema":{"type":"string"},"description":"How long to wait before retrying, in seconds."}},"content":{"application/json":{"schema":{"type":"object","description":"`{\"error\": {…}}` — the body of every non-2xx answer outside `/v1/messages`.","required":["error"],"properties":{"error":{"type":"object","description":"The failure itself, and the envelope's only member.","required":["type","message"],"properties":{"type":{"type":"string","description":"The class of the failure; a provider's own class can reach you unchanged.","examples":["invalid_request_error","authentication_required","invalid_api_key","invalid_provisioning_key","invalid_session_token","disabled_api_key","disabled_provisioning_key","expired_api_key","credit_limit_exceeded","rate_limit_exceeded","model_deprecated","inappropriate_content","billing_metering_incomplete","billing_request_id_invalid","billing_writer_missing","server_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","description":"The human-readable sentence shown to the caller.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"rate-limited":{"title":"rate-limited","summary":"429 — too many requests; `Retry-After` carries the wait","value":{"error":{"type":"rate_limit_exceeded","message":"Free model limit reached (100 requests per day and 10 per minute). Try again in 3s, or add credits at https://naga.ac/dashboard/credits to use paid models, which have no request limit."}}}},"exampleType":"examples"}},"x-retry-safe":true,"exampleType":"examples"},"cf63755a-d5ef-4f9c-b98d-11bd49702810":{"description":"The gateway failed for a reason of its own. Report it — this status marks NagaAI's own bugs, never an upstream verdict.","content":{"application/json":{"schema":{"type":"object","description":"`{\"error\": {…}}` — the body of every non-2xx answer outside `/v1/messages`.","required":["error"],"properties":{"error":{"type":"object","description":"The failure itself, and the envelope's only member.","required":["type","message"],"properties":{"type":{"type":"string","description":"The class of the failure; a provider's own class can reach you unchanged.","examples":["invalid_request_error","authentication_required","invalid_api_key","invalid_provisioning_key","invalid_session_token","disabled_api_key","disabled_provisioning_key","expired_api_key","credit_limit_exceeded","rate_limit_exceeded","model_deprecated","inappropriate_content","billing_metering_incomplete","billing_request_id_invalid","billing_writer_missing","server_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","description":"The human-readable sentence shown to the caller.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>"}}}},"exampleType":"generated"}},"x-retry-safe":true,"exampleType":"generated"},"2142ebfb-a75a-4765-aefa-004c7151cfb5":{"description":"No upstream is available, or the gateway is shedding load. `Retry-After` carries the suggested wait.","headers":{"Retry-After":{"schema":{"type":"string"},"description":"How long to wait before retrying, in seconds."}},"content":{"application/json":{"schema":{"type":"object","description":"`{\"error\": {…}}` — the body of every non-2xx answer outside `/v1/messages`.","required":["error"],"properties":{"error":{"type":"object","description":"The failure itself, and the envelope's only member.","required":["type","message"],"properties":{"type":{"type":"string","description":"The class of the failure; a provider's own class can reach you unchanged.","examples":["invalid_request_error","authentication_required","invalid_api_key","invalid_provisioning_key","invalid_session_token","disabled_api_key","disabled_provisioning_key","expired_api_key","credit_limit_exceeded","rate_limit_exceeded","model_deprecated","inappropriate_content","billing_metering_incomplete","billing_request_id_invalid","billing_writer_missing","server_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","description":"The human-readable sentence shown to the caller.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The finer-grained code, when the failure has one.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request field the failure is about, when it is about one.","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>"}}}},"exampleType":"generated"}},"x-retry-safe":true,"exampleType":"generated"}},"security":{"26d809cb-6363-40ed-b33e-0635e21a4579":{"bearerAuth":{"type":"http","scheme":"bearer","description":"An account API key. Send it as `Authorization: Bearer \u003ckey>`.","scopes":[],"schemeName":"bearerAuth"}},"8ebc2ea0-3893-494f-907a-a8c04041f58f":{"xApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"An account API key. Send it as `x-api-key: \u003ckey>`, the header Anthropic-style clients use.","scopes":[],"schemeName":"xApiKeyAuth"}}},"servers":{"ddee1100-762b-4028-ac39-d54cdb9aa21e":{"url":"https://api.naga.ac","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"An account API key. Send it as `Authorization: Bearer \u003ckey>`.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An account API key. Send it as `Authorization: Bearer \u003ckey>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"An account API key. Send it as `x-api-key: \u003ckey>`, the header Anthropic-style clients use.","scopes":[],"schemeName":"xApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"An account API key. Send it as `x-api-key: \u003ckey>`, the header Anthropic-style clients use.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"xApiKeyAuth","name":"x-api-key"}],"title":"xApiKeyAuth"}]},"originalFileLocation":"openapi/naga-api.json"},"subdomain":"nagaai-60f8697b","siteName":"NagaAI Documentation","title":"Create a transcription - NagaAI Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T16:54:45.349Z","originalFileLocation":"api-reference/audio/create-a-transcription.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Converts uploaded audio into text in the language that was spoken and charges the account for what it counted. Requires an API key. /v1/audio/translations answers in English instead.\">\u003cmeta data-mint-head name=\"application-name\" content=\"NagaAI Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/nagaai-60f8697b/GL7s2nR26U7RrKZ8/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/nagaai-60f8697b/GL7s2nR26U7RrKZ8/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/nagaai-60f8697b/GL7s2nR26U7RrKZ8/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/nagaai-60f8697b/GL7s2nR26U7RrKZ8/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/nagaai-60f8697b/GL7s2nR26U7RrKZ8/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/nagaai-60f8697b/GL7s2nR26U7RrKZ8/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/nagaai-60f8697b/GL7s2nR26U7RrKZ8/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/nagaai-60f8697b/GL7s2nR26U7RrKZ8/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/nagaai-60f8697b/GL7s2nR26U7RrKZ8/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a transcription - NagaAI Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Converts uploaded audio into text in the language that was spoken and charges the account for what it counted. Requires an API key. /v1/audio/translations answers in English instead.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"NagaAI Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.naga.ac/api-reference/audio/create-a-transcription\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://nagaai-60f8697b.mintlify.site/_mintlify/api/og/v2?division=Audio\u0026amp;title=Create+a+transcription\u0026amp;description=Converts+uploaded+audio+into+text+in+the+language+that+was+spoken+and+charges+the+account+for+what+it+counted.+Requires+an+API+key.+%60%2Fv1%2Faudio%2Ftranslations%60+ans\u0026amp;theme=53b53c58c5b757ba80c9164d\u0026amp;signature=7066c822d26480c8895312ea549621ffb7205399321f585685afe39a269bf933\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a transcription - NagaAI Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Converts uploaded audio into text in the language that was spoken and charges the account for what it counted. Requires an API key. /v1/audio/translations answers in English instead.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://nagaai-60f8697b.mintlify.site/_mintlify/api/og/v2?division=Audio\u0026amp;title=Create+a+transcription\u0026amp;description=Converts+uploaded+audio+into+text+in+the+language+that+was+spoken+and+charges+the+account+for+what+it+counted.+Requires+an+API+key.+%60%2Fv1%2Faudio%2Ftranslations%60+ans\u0026amp;theme=53b53c58c5b757ba80c9164d\u0026amp;signature=7066c822d26480c8895312ea549621ffb7205399321f585685afe39a269bf933\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/nagaai-60f8697b/GL7s2nR26U7RrKZ8/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"NagaAI Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5a5ae5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.naga.ac/api-reference/audio/create-a-transcription\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/audio/create-a-transcription.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.naga.ac/#organization\",\"name\":\"NagaAI Documentation\",\"url\":\"https://docs.naga.ac\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/nagaai-60f8697b/3Tc2Ajidq18FPFoC/static/img/logo-light.svg?fit=max\u0026auto=format\u0026n=3Tc2Ajidq18FPFoC\u0026q=85\u0026s=18d579338bd90baa596e41e2e2322393\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.naga.ac#website\",\"name\":\"NagaAI Documentation\",\"url\":\"https://docs.naga.ac\",\"publisher\":{\"@id\":\"https://docs.naga.ac/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.naga.ac/api-reference/audio/create-a-transcription#webpage\",\"url\":\"https://docs.naga.ac/api-reference/audio/create-a-transcription\",\"name\":\"Create a transcription\",\"description\":\"Converts uploaded audio into text in the language that was spoken and charges the account for what it counted. Requires an API key. /v1/audio/translations answers in English instead.\",\"dateModified\":\"2026-11-19T16:54:45.349Z\",\"isPartOf\":{\"@id\":\"https://docs.naga.ac#website\"},\"breadcrumb\":{\"@id\":\"https://docs.naga.ac/api-reference/audio/create-a-transcription#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.naga.ac/api-reference/audio/create-a-transcription#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.naga.ac/api-reference/responses/create-a-response\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Audio\",\"item\":\"https://docs.naga.ac/api-reference/audio/create-speech\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create a transcription\",\"item\":\"https://docs.naga.ac/api-reference/audio/create-a-transcription\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.naga.ac/api-reference/audio/create-a-transcription#apireference\",\"headline\":\"Create a transcription\",\"name\":\"Create a transcription\",\"description\":\"Converts uploaded audio into text in the language that was spoken and charges the account for what it counted. Requires an API key. /v1/audio/translations answers in English instead.\",\"url\":\"https://docs.naga.ac/api-reference/audio/create-a-transcription\",\"mainEntityOfPage\":{\"@id\":\"https://docs.naga.ac/api-reference/audio/create-a-transcription#webpage\"},\"dateModified\":\"2026-11-19T16:54:45.349Z\",\"publisher\":{\"@id\":\"https://docs.naga.ac/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.naga.ac#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"NagaAI Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"NagaAI Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/audio/create-a-transcription.md","siteName":"NagaAI Documentation","nav":{"global":null,"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":"/get-started/quickstart"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API reference","sidebarTitle":"Overview","icon":"book","href":"/api-reference/overview"}]},{"group":"Endpoints","pages":[{"group":"Responses","expanded":false,"pages":[{"title":"Create a response","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json post /v1/responses","href":"/api-reference/responses/create-a-response"}]},{"group":"Chat Completions","expanded":false,"pages":[{"title":"Create a chat completion","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json post /v1/chat/completions","href":"/api-reference/chat-completions/create-a-chat-completion"}]},{"group":"Messages","expanded":false,"pages":[{"title":"Create a message","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json post /v1/messages","href":"/api-reference/messages/create-a-message"}]},{"group":"Models","expanded":false,"pages":[{"title":"List models","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json get /v1/models","href":"/api-reference/models/list-models"}]},{"group":"Startups","expanded":false,"pages":[{"title":"List startups","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json get /v1/startups","href":"/api-reference/startups/list-startups"}]},{"group":"Embeddings","expanded":false,"pages":[{"title":"Create embeddings","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json post /v1/embeddings","href":"/api-reference/embeddings/create-embeddings"}]},{"group":"Moderations","expanded":false,"pages":[{"title":"Classify content","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json post /v1/moderations","href":"/api-reference/moderations/classify-content"}]},{"group":"Rerank","expanded":false,"pages":[{"title":"Rerank documents","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json post /v1/rerank","href":"/api-reference/rerank/rerank-documents"}]},{"group":"Audio","expanded":false,"pages":[{"title":"Create speech","description":"Converts text into spoken audio and charges the account for what it counted. Requires an API key.","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json post /v1/audio/speech","href":"/api-reference/audio/create-speech"},{"title":"Create a transcription","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json post /v1/audio/transcriptions","href":"/api-reference/audio/create-a-transcription"},{"title":"Create a translation","description":"Converts uploaded audio into English text and charges the account for what it counted. Requires an API key. `/v1/audio/transcriptions` answers in the language that was spoken.","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json post /v1/audio/translations","href":"/api-reference/audio/create-a-translation"}]},{"group":"Images","expanded":false,"pages":[{"title":"Create an image","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json post /v1/images/generations","href":"/api-reference/images/create-an-image"},{"title":"Edit an image","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json post /v1/images/edits","href":"/api-reference/images/edit-an-image"}]},{"group":"Videos","expanded":false,"pages":[{"title":"Create a video","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json post /v1/videos","href":"/api-reference/videos/create-a-video"},{"title":"Get a video job","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json get /v1/videos/{id}","href":"/api-reference/videos/get-a-video-job"},{"title":"Download a video","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json get /v1/videos/{id}/content","href":"/api-reference/videos/download-a-video"}]},{"group":"Requests","expanded":false,"pages":[{"title":"Get a request","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json get /v1/requests/{id}","href":"/api-reference/requests/get-a-request"}]},{"group":"Account","expanded":false,"pages":[{"title":"Get the account balance","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json get /v1/account/balance","href":"/api-reference/account/get-the-account-balance"},{"title":"Get account activity","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json get /v1/account/activity","href":"/api-reference/account/get-account-activity"},{"group":"API Keys","expanded":false,"pages":[{"title":"List API keys","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json get /v1/account/keys","href":"/api-reference/api-keys/list-api-keys"},{"title":"Create an API key","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json post /v1/account/keys","href":"/api-reference/api-keys/create-an-api-key"},{"title":"Get an API key","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json get /v1/account/keys/{key_id}","href":"/api-reference/api-keys/get-an-api-key"},{"title":"Update an API key","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json patch /v1/account/keys/{key_id}","href":"/api-reference/api-keys/update-an-api-key"},{"title":"Delete an API key","deprecated":null,"version":null,"openapi":"/openapi/naga-api.json delete /v1/account/keys/{key_id}","href":"/api-reference/api-keys/delete-an-api-key"}]}]}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/agents/claude-code"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Create a transcription - NagaAI Documentation","deploymentId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","buildId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BtG4DSkw.js","snippetPresets-C1k1xDhp.js","utils-PMJoEt4Y.js","style-to-object-BY3JEAdk.js","utils-DW3Pr7Jq.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DIISLO2w.js","conditional-requirements-CFM0id0Q.js","cloneDeep-BErNCZCm.js","_Uint8Array-f0PCu9f_.js","isObject-FP1Yky1u.js","ApiExamples-OjY-8mqu.js","usePlaygroundInputsStore-B2HS2hUb.js","shallow-DVFuuIDQ.js","isEqual-DG0UKiQC.js","CodeSnippets-Cy6FBgwN.js","CodeSnippet-D1PtG8ed.js","getApiPlaygroundDisplay-Dkx2eNtL.js","Page-C8Cg25if.js","DynamicMarkdown-BvJIe00T.js","SectionHeading-B0rKYV8d.js","icon-yclzBff4.js","MethodPill-DxA11cCF.js","getPastedJson-CpkIDpMk.js","DuplicateIcon-CFCQNJ-D.js","axios-CsQoIw0U.js","Markdown-CK5C-fmV.js","AssistantPageLink-Cw134Dd-.js","dist-3xM3Qrc7.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}