@juspay/neurolink 12.25.0 → 12.25.2

package/docs-site/static/search-index.json

@@ -5462,10 +5462,10 @@
 {"objectID":"a0720e2017f4d4189cdb29848c4023c40b9e66f58fca8fd88d41ce87a1ab783f","title":"Streaming WebSocket disconnects","url":"/docs/getting-started/providers/deepgram#streaming-websocket-disconnects","content":"Check that  is valid and that your network allows outbound WebSocket connections to . Firewall or proxy configurations may block WebSocket upgrades.","hierarchy":{"lvl0":"Getting Started","lvl1":"Deepgram Provider Guide","lvl2":"Streaming WebSocket disconnects","lvl3":""}},
 {"objectID":"27de57f1a55130cc5f2cf7e470801eff52bf6a056c6e29e62498f7a441b22a3a","title":"Diarization not appearing in results","url":"/docs/getting-started/providers/deepgram#diarization-not-appearing-in-results","content":"Diarization requires multi-speaker audio with clearly separated voices. Single-speaker audio will return no speaker labels. Also confirm  is set, and that you are using a model that supports it (Nova-2 and above).","hierarchy":{"lvl0":"Getting Started","lvl1":"Deepgram Provider Guide","lvl2":"Diarization not appearing in results","lvl3":""}},
 {"objectID":"b7d80419b846034a24796f9bc7f22b7458c21238354ae728c236e8c0573e5dd2","title":"See Also","url":"/docs/getting-started/providers/deepgram#see-also","content":"Audio Input (STT) Guide — complete multi-provider STT reference\nVoice Agent Guide — building full voice assistants\nOpenAI TTS Provider Guide — text-to-speech counterpart\nElevenLabs Provider Guide — alternative TTS with voice cloning\n\nNeed Help? Join the GitHub Discussions or open an issue.","hierarchy":{"lvl0":"Getting Started","lvl1":"Deepgram Provider Guide","lvl2":"See Also","lvl3":""}},
-{"objectID":"f0011413e792381f4d6131f700afe5f7742598666be073cf1f98530c99fd5138","title":"DeepSeek Provider Guide","url":"/docs/getting-started/providers/deepseek","content":"DeepSeek Provider Guide\n\nText generation with DeepSeek-V3 (chat) and DeepSeek-R1 (reasoning) through a single API\n\nOverview\n\nDeepSeek is a Chinese AI research lab offering highly capable open-weight models via a hosted cloud API. NeuroLink wraps their OpenAI-compatible endpoint, giving you access to two model families:\n— DeepSeek-V3, a 671B mixture-of-experts model optimised for everyday chat and code tasks. Supports tool calling and structured output.\n— DeepSeek-R1, a reasoning model that performs extended chain-of-thought before producing an answer. The AI SDK surfaces the reasoning trace separately so you can inspect it.\n\nKey Facts\nProtocol: OpenAI-compatible ()\nDefault base URL: \nContext window: 64K tokens (both models)\nVision: Not supported — text-only\nStreaming: Supported\nTool calling: Supported on ; limited on \nReasoning trace:  exposes  (surfaced as  parts in the AI SDK response)\n\nQuick Start\nGet an API Key\n\nSign up at https://platform.deepseek.com and create an API key under API Keys.\nConfigure Environment\n\nAdd to your  file:\nInstall NeuroLink\nGenerate Your First Response\n\nSupported Models\n\n| Model ID            | Family      | Context | Tool Calling | Notes                                       |\n| ------------------- | ----------- | ------- | ------------ | ------------------------------------------- |\n|      | DeepSeek-V3 | 64K     | Yes          | Default; best for chat and code tasks       |\n|  | DeepSeek-R1 | 64K     | Limited      | Extended reasoning; exposes reasoning trace |\n\nPass any model ID via  (CLI) or  (SDK). Only these two models are officially hosted on .\n\nSDK Usage\n\nBasic Generation\n\nUsing the Reasoner Model\n\nNote:  produces a longer response latency because it thinks before answering.\n\nStreaming\n\nPer-Call Credential Override\n\nPass credentials at call time to override the instance-level or environment-variable defaults. Useful when routing requests for different users through separate DeepSeek accounts.\n\nYou can also override the base URL per call — useful when pointing at a self-hosted OpenAI-compatible proxy in front of DeepSeek:\n\nCLI Usage\n\nBasic Commands\n\nStreaming via CLI\n\nThe CLI streams output by default when a TTY is attached. No extra flags are required.\n\nProvider Aliases\n\nThe DeepSeek provider can be referenced by any of the following names:\n\n| Alias      | Example               |\n| ---------- | --------------------- |\n|  |  |\n|        |        |\n\nConfiguration Reference\n\n| Environment Variable | Required | Default                    | Description                                 |\n| -------------------- | -------- | -------------------------- | ------------------------------------------- |\n|    | Yes      | —                          | DeepSeek API key (starts with )        |\n|      | No       |             | Default model to use                        |\n|   | No       |  | Base URL for the API (override for proxies) |\n\nFeature Support Matrix\n\n| Feature           |  |  |\n| ----------------- | --------------- | ------------------- |\n| Text generation   | Yes             | Yes                 |\n| Streaming         | Yes             | Yes                 |\n| Tool calling      | Yes             | Limited             |\n| Structured output | Yes             | Limited             |\n| Vision / images   | No              | No                  |\n| Embeddings        | No              | No                  |\n| Reasoning trace   | No              | Yes                 |\n\nTroubleshooting\n\n\"Invalid DeepSeek API key\"\n\nThe  is missing or incorrect.\n\nGet or rotate keys at https://platform.deepseek.com/api_keys.\n\n\"DeepSeek account has insufficient balance\"\n\nYour account credit is exhausted. Top up at https://platform.deepseek.com/usage.\n\n\"DeepSeek rate limit exceeded\"\n\nToo many requests in a short window. Implement exponential backoff or reduce request concurrency. Rate limits are published in the DeepSeek API docs.\n\n\"Model not found\"\n\nOnly  and  are hosted on . Check the model name for typos.\n\nSlow responses on \n\nExpected. R1 performs extended chain-of-thought reasoning before producing its final answer, which adds latency proportional to reasoning complexity. Use  for latency-sensitive paths.\n\nTool calls failing on \n\nDeepSeek documents limited tool support on R1. For tool-heavy workflows, use .\n\nSee Also\nImplementation spec — internal wire-format details and design decisions\nOpenAI Compatible provider — generic provider for any OpenAI-compatible endpoint\nLiteLLM provider — proxy-based multi-provider access\n\nNeed Help? Join the GitHub Discussions or open an issue.","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"","lvl3":""}},
-{"objectID":"958538aa2497f8c0121993c79063ab03a4e9182ad54e8e826fac34ccf66059d2","title":"DeepSeek Provider Guide","url":"/docs/getting-started/providers/deepseek#deepseek-provider-guide","content":"Text generation with DeepSeek-V3 (chat) and DeepSeek-R1 (reasoning) through a single API","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"DeepSeek Provider Guide","lvl3":""}},
-{"objectID":"c3e1684d29fb0fb80d0a6c08cccede4c72627e18920573ed08ace68662625d5e","title":"Overview","url":"/docs/getting-started/providers/deepseek#overview","content":"DeepSeek is a Chinese AI research lab offering highly capable open-weight models via a hosted cloud API. NeuroLink wraps their OpenAI-compatible endpoint, giving you access to two model families:\n— DeepSeek-V3, a 671B mixture-of-experts model optimised for everyday chat and code tasks. Supports tool calling and structured output.\n— DeepSeek-R1, a reasoning model that performs extended chain-of-thought before producing an answer. The AI SDK surfaces the reasoning trace separately so you can inspect it.","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Overview","lvl3":""}},
-{"objectID":"90018a4be75353babd3c1ed5c9f76895280adfbeaad70cff5718ac9f60d46d88","title":"Key Facts","url":"/docs/getting-started/providers/deepseek#key-facts","content":"Protocol: OpenAI-compatible ()\nDefault base URL: \nContext window: 64K tokens (both models)\nVision: Not supported — text-only\nStreaming: Supported\nTool calling: Supported on ; limited on \nReasoning trace:  exposes  (surfaced as  parts in the AI SDK response)","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Key Facts","lvl3":""}},
+{"objectID":"f0011413e792381f4d6131f700afe5f7742598666be073cf1f98530c99fd5138","title":"DeepSeek Provider Guide","url":"/docs/getting-started/providers/deepseek","content":"DeepSeek Provider Guide\n\nText and image input with DeepSeek-V4.1-Flash and DeepSeek-V4-Pro through a single API\n\nOverview\n\nDeepSeek is a Chinese AI research lab offering highly capable open-weight models via a hosted cloud API. NeuroLink wraps their OpenAI-compatible endpoint. The API serves two models:\n— DeepSeek-V4.1-Flash. Reads images as well as text.\n— DeepSeek-V4-Pro-0813. Text only.\n\nThe older ids still work as aliases of : * answers with thinking off, and * answers with thinking on and returns a reasoning trace.\n\nKey Facts\nProtocol: OpenAI-compatible ()\nDefault base URL: \nContext window: 1M tokens (1,048,576), with up to 384K (393,216) output tokens\nVision:  and its aliases; not reasoningcontentdeepseek-reasoner.envdeepseek-chatdeepseek-flashdeepseek-reasonerdeepseek-flashdeepseek-flashdeepseek-v4-pro--modelmodel:GET /modelsapi.deepseek.comdeepseek-flashdeepseek-v4-prodeepseek--provider deepseekds--provider dsDEEPSEEKAPIKEYsk-DEEPSEEKMODELdeepseek-chatDEEPSEEKBASEURLhttps://api.deepseek.comdeepseek-chatdeepseek-reasonerdeepseek-flashdeepseek-v4-proDEEPSEEKAPIKEY400deepseek-chatdeepseek-reasonerdeepseek-reasonerdeepseek-flashdeepseek-v4-prodeepseek-chatreasoning_content400deepseek-chat`, which keeps thinking off.\n\nSee Also\nImplementation spec — internal wire-format details and design decisions\nOpenAI Compatible provider — generic provider for any OpenAI-compatible endpoint\nLiteLLM provider — proxy-based multi-provider access\n\nNeed Help? Join the GitHub Discussions or open an issue.","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"","lvl3":""}},
+{"objectID":"958538aa2497f8c0121993c79063ab03a4e9182ad54e8e826fac34ccf66059d2","title":"DeepSeek Provider Guide","url":"/docs/getting-started/providers/deepseek#deepseek-provider-guide","content":"Text and image input with DeepSeek-V4.1-Flash and DeepSeek-V4-Pro through a single API","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"DeepSeek Provider Guide","lvl3":""}},
+{"objectID":"c3e1684d29fb0fb80d0a6c08cccede4c72627e18920573ed08ace68662625d5e","title":"Overview","url":"/docs/getting-started/providers/deepseek#overview","content":"DeepSeek is a Chinese AI research lab offering highly capable open-weight models via a hosted cloud API. NeuroLink wraps their OpenAI-compatible endpoint. The API serves two models:\n— DeepSeek-V4.1-Flash. Reads images as well as text.\n— DeepSeek-V4-Pro-0813. Text only.\n\nThe older ids still work as aliases of : * answers with thinking off, and * answers with thinking on and returns a reasoning trace.","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Overview","lvl3":""}},
+{"objectID":"90018a4be75353babd3c1ed5c9f76895280adfbeaad70cff5718ac9f60d46d88","title":"Key Facts","url":"/docs/getting-started/providers/deepseek#key-facts","content":"Protocol: OpenAI-compatible ()\nDefault base URL: \nContext window: 1M tokens (1,048,576), with up to 384K (393,216) output tokens\nVision:  and its aliases; not reasoning_contentdeepseek-reasoner`)","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Key Facts","lvl3":""}},
 {"objectID":"305803a4e9c944a1b9b2fc22fdcb96e2c1653bbb43e170e0ebc1fc88705f57f2","title":"1. Get an API Key","url":"/docs/getting-started/providers/deepseek#1-get-an-api-key","content":"Sign up at https://platform.deepseek.com and create an API key under API Keys.","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"1. Get an API Key","lvl3":""}},
 {"objectID":"1de6146c363d4139cac7191b36356838a742db03ae156fac5c0c6417c687c370","title":"2. Configure Environment","url":"/docs/getting-started/providers/deepseek#2-configure-environment","content":"Add to your  file:\n\n`bash","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"2. Configure Environment","lvl3":""}},
 {"objectID":"d24a327297806b341e71999e6add069ebdc54c6b41b66ce4140ba5706de15fa2","title":"Required","url":"/docs/getting-started/providers/deepseek#required","content":"DEEPSEEKAPIKEY=sk-...","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Required","lvl3":""}},
@@ -5473,8 +5473,8 @@
 {"objectID":"8f249a932b63d7576c330cb47861fa3d7ee4865d900d3a712651dec2483bb77c","title":"Optional: override the base URL (default: https://api.deepseek.com)","url":"/docs/getting-started/providers/deepseek#optional-override-the-base-url-default-httpsapideepseekcom","content":"DEEPSEEKBASEURL=https://api.deepseek.com\n`","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Optional: override the base URL (default: https://api.deepseek.com)","lvl3":""}},
 {"objectID":"b4f7d6436f91b94c780c0aff81a5c8dd9e9d4884a7edfac2c88371b0f5418632","title":"3. Install NeuroLink","url":"/docs/getting-started/providers/deepseek#3-install-neurolink","content":"`bash\nnpm install @juspay/neurolink","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"3. Install NeuroLink","lvl3":""}},
 {"objectID":"b824af77427753e70427acd9540e9a542fe553260bf7b8cabbe33f6068ddf542","title":"or","url":"/docs/getting-started/providers/deepseek#or","content":"pnpm add @juspay/neurolink\n`","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"or","lvl3":""}},
-{"objectID":"efda4fbe6815a90781b6adb092a3ce102b74a3de6f9e8a51b24476a3b499b0cc","title":"Supported Models","url":"/docs/getting-started/providers/deepseek#supported-models","content":"| Model ID            | Family      | Context | Tool Calling | Notes                                       |\n| ------------------- | ----------- | ------- | ------------ | ------------------------------------------- |\n|      | DeepSeek-V3 | 64K     | Yes          | Default; best for chat and code tasks       |\n|  | DeepSeek-R1 | 64K     | Limited      | Extended reasoning; exposes reasoning trace |\n\nPass any model ID via  (CLI) or  (SDK). Only these two models are officially hosted on .","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Supported Models","lvl3":""}},
-{"objectID":"1574d51e68146899c67346042e4058b73556d0a7423c109bfc0cbaf9ef0a761f","title":"Using the Reasoner Model","url":"/docs/getting-started/providers/deepseek#using-the-reasoner-model","content":"Note:  produces a longer response latency because it thinks before answering.","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Using the Reasoner Model","lvl3":""}},
+{"objectID":"efda4fbe6815a90781b6adb092a3ce102b74a3de6f9e8a51b24476a3b499b0cc","title":"Supported Models","url":"/docs/getting-started/providers/deepseek#supported-models","content":"| Model ID            | Serves              | Context | Images | Notes                                            |\n| ------------------- | ------------------- | ------- | ------ | ------------------------------------------------ |\n|      | DeepSeek-V4.1-Flash | 1M      | Yes    | Default; alias of , thinking off |\n|  | DeepSeek-V4.1-Flash | 1M      | Yes    | Alias of , thinking on           |\n|     | DeepSeek-V4.1-Flash | 1M      | Yes    | Thinking on by default                           |\n|    | DeepSeek-V4-Pro     | 1M      | No     | Thinking on by default                           |\n\nPass any model ID via  (CLI) or  (SDK).  on  lists only  and ; the two older ids are accepted as aliases.","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Supported Models","lvl3":""}},
+{"objectID":"1574d51e68146899c67346042e4058b73556d0a7423c109bfc0cbaf9ef0a761f","title":"Using the Reasoner Model","url":"/docs/getting-started/providers/deepseek#using-the-reasoner-model","content":"Note: with thinking on, responses take longer because the model reasons before answering.","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Using the Reasoner Model","lvl3":""}},
 {"objectID":"052012b12d0e9fd5f6c6b6345cb0ac46eb5d5c106e30d6fe9c947bf97d0d2e59","title":"Per-Call Credential Override","url":"/docs/getting-started/providers/deepseek#per-call-credential-override","content":"Pass credentials at call time to override the instance-level or environment-variable defaults. Useful when routing requests for different users through separate DeepSeek accounts.\n\nYou can also override the base URL per call — useful when pointing at a self-hosted OpenAI-compatible proxy in front of DeepSeek:","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Per-Call Credential Override","lvl3":""}},
 {"objectID":"4a79f7cf87df3b212e2b9eccea6892c48f2f3cc2d78a00c6e18cf0bc61b1670e","title":"Basic Commands","url":"/docs/getting-started/providers/deepseek#basic-commands","content":"`bash","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Basic Commands","lvl3":""}},
 {"objectID":"e3e118ab6d9315151c533c73778fa913cb8b913290aeff45ea1a19d4249b50f6","title":"Generate with default model (deepseek-chat)","url":"/docs/getting-started/providers/deepseek#generate-with-default-model-deepseek-chat","content":"pnpm run cli generate \"What is the halting problem?\" --provider deepseek","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Generate with default model (deepseek-chat)","lvl3":""}},
@@ -5484,15 +5484,15 @@
 {"objectID":"97745b69cc39a0c49f07335a1229d41da5bb154a39be3ead063054c618ff46a4","title":"Streaming via CLI","url":"/docs/getting-started/providers/deepseek#streaming-via-cli","content":"The CLI streams output by default when a TTY is attached. No extra flags are required.","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Streaming via CLI","lvl3":""}},
 {"objectID":"ed4dfd86cf90167cd1ce9f0cf73dfd194acc9ef6b5f2ea36432667549e64c937","title":"Provider Aliases","url":"/docs/getting-started/providers/deepseek#provider-aliases","content":"The DeepSeek provider can be referenced by any of the following names:\n\n| Alias      | Example               |\n| ---------- | --------------------- |\n|  |  |\n|        |        |","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Provider Aliases","lvl3":""}},
 {"objectID":"ee93faea0a3dac33a16ed609b540a3c4d740b078be904e91f12d93aab0117d27","title":"Configuration Reference","url":"/docs/getting-started/providers/deepseek#configuration-reference","content":"| Environment Variable | Required | Default                    | Description                                 |\n| -------------------- | -------- | -------------------------- | ------------------------------------------- |\n|    | Yes      | —                          | DeepSeek API key (starts with )        |\n|      | No       |             | Default model to use                        |\n|   | No       |  | Base URL for the API (override for proxies) |","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Configuration Reference","lvl3":""}},
-{"objectID":"96de170928a0c7cf159591ea3111960422e82d9e2583785718021bb9bdda2400","title":"Feature Support Matrix","url":"/docs/getting-started/providers/deepseek#feature-support-matrix","content":"| Feature           |  |  |\n| ----------------- | --------------- | ------------------- |\n| Text generation   | Yes             | Yes                 |\n| Streaming         | Yes             | Yes                 |\n| Tool calling      | Yes             | Limited             |\n| Structured output | Yes             | Limited             |\n| Vision / images   | No              | No                  |\n| Embeddings        | No              | No                  |\n| Reasoning trace   | No              | Yes                 |","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Feature Support Matrix","lvl3":""}},
+{"objectID":"96de170928a0c7cf159591ea3111960422e82d9e2583785718021bb9bdda2400","title":"Feature Support Matrix","url":"/docs/getting-started/providers/deepseek#feature-support-matrix","content":"| Feature           |  |  |  |  |\n| ----------------- | --------------- | ------------------- | ---------------- | ----------------- |\n| Text generation   | Yes             | Yes                 | Yes              | Yes               |\n| Streaming         | Yes             | Yes                 | Yes              | Yes               |\n| Tool calling      | Yes             | See below           | See below        | See below         |\n| Structured output | Yes             | Not tested          | Not tested       | Not tested        |\n| Vision / images   | Yes             | Yes                 | Yes              | No                |\n| Embeddings        | No              | No                  | No               | No                |\n| Reasoning trace   | No              | Yes                 | Yes              | Yes               |","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Feature Support Matrix","lvl3":""}},
 {"objectID":"3231260189e6a4a38cc5eb1b8250aafacac777f6235f29e0efdeb9cc2263a16c","title":"\"Invalid DeepSeek API key\"","url":"/docs/getting-started/providers/deepseek#invalid-deepseek-api-key","content":"The  is missing or incorrect.\n\n`bash","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"\"Invalid DeepSeek API key\"","lvl3":""}},
 {"objectID":"e76d49f1afb161543ab8cd1e017763d740ae0a41d31a2a9084448fdf94ecdcb2","title":"Verify the variable is set","url":"/docs/getting-started/providers/deepseek#verify-the-variable-is-set","content":"echo $DEEPSEEKAPIKEY","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Verify the variable is set","lvl3":""}},
 {"objectID":"f2faab6113b9ad539936bfaf050aec86df1e0395bdc082e2725c3f91c80c8ca7","title":"Set it inline","url":"/docs/getting-started/providers/deepseek#set-it-inline","content":"`\n\nGet or rotate keys at https://platform.deepseek.com/api_keys.","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Set it inline","lvl3":""}},
 {"objectID":"b645b2e26445e403c19051e0931f3b815ce9cedacbbbcd5d0459d465fa012ede","title":"\"DeepSeek account has insufficient balance\"","url":"/docs/getting-started/providers/deepseek#deepseek-account-has-insufficient-balance","content":"Your account credit is exhausted. Top up at https://platform.deepseek.com/usage.","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"\"DeepSeek account has insufficient balance\"","lvl3":""}},
 {"objectID":"54989b947cc0840d9d58abc26fce361c1c0c678c2ebef38eb352dc221da6b43c","title":"\"DeepSeek rate limit exceeded\"","url":"/docs/getting-started/providers/deepseek#deepseek-rate-limit-exceeded","content":"Too many requests in a short window. Implement exponential backoff or reduce request concurrency. Rate limits are published in the DeepSeek API docs.","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"\"DeepSeek rate limit exceeded\"","lvl3":""}},
-{"objectID":"bcadc6d16aa1af4c9dd5e509db1ee7f587179ae8ca9d98e7240408c739991802","title":"\"Model not found\"","url":"/docs/getting-started/providers/deepseek#model-not-found","content":"Only  and  are hosted on . Check the model name for typos.","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"\"Model not found\"","lvl3":""}},
-{"objectID":"1fd3f0446b9a2372f64c02fb070d397cbced4d9b46af189b469892737e3755eb","title":"Slow responses on deepseek-reasoner","url":"/docs/getting-started/providers/deepseek#slow-responses-on-deepseek-reasoner","content":"Expected. R1 performs extended chain-of-thought reasoning before producing its final answer, which adds latency proportional to reasoning complexity. Use  for latency-sensitive paths.","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Slow responses on deepseek-reasoner","lvl3":""}},
-{"objectID":"53837d1463897d5b10f7f74918b3cdbdab096055a0b095f873b539a5e52fed1f","title":"Tool calls failing on deepseek-reasoner","url":"/docs/getting-started/providers/deepseek#tool-calls-failing-on-deepseek-reasoner","content":"DeepSeek documents limited tool support on R1. For tool-heavy workflows, use .","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Tool calls failing on deepseek-reasoner","lvl3":""}},
+{"objectID":"bcadc6d16aa1af4c9dd5e509db1ee7f587179ae8ca9d98e7240408c739991802","title":"\"Model not found\"","url":"/docs/getting-started/providers/deepseek#model-not-found","content":"DeepSeek answers an unknown id with  and \"The supported API model names are deepseek-flash, deepseek-v4-pro\". Use one of those, or the  /  aliases.","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"\"Model not found\"","lvl3":""}},
+{"objectID":"5d6c41711a9d937d9546d0227eee7fce427c5cdff6f8d549cf4e4171ba66b5d7","title":"Slow responses with thinking on","url":"/docs/getting-started/providers/deepseek#slow-responses-with-thinking-on","content":"Expected. ,  and  reason before answering, which adds latency. Use  for latency-sensitive paths.","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Slow responses with thinking on","lvl3":""}},
+{"objectID":"b507cb02f53bda7fec320d54c24a3a6d33e5e17bda8fe60622265712c2e59944","title":"Tool calls failing with thinking on","url":"/docs/getting-started/providers/deepseek#tool-calls-failing-with-thinking-on","content":"DeepSeek requires  to be sent back on every later request once tools are in play, and returns  otherwise (thinking mode guide). For tool-heavy workflows, use , which keeps thinking off.","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"Tool calls failing with thinking on","lvl3":""}},
 {"objectID":"892870aad241356c56f5445ecf528a3a7b6ba11c3eedea3673715106da0ef59d","title":"See Also","url":"/docs/getting-started/providers/deepseek#see-also","content":"Implementation spec — internal wire-format details and design decisions\nOpenAI Compatible provider — generic provider for any OpenAI-compatible endpoint\nLiteLLM provider — proxy-based multi-provider access\n\nNeed Help? Join the GitHub Discussions or open an issue.","hierarchy":{"lvl0":"Getting Started","lvl1":"DeepSeek Provider Guide","lvl2":"See Also","lvl3":""}},
 {"objectID":"b3dc872a8aa0c095281226e80d35c5d769d99952788bf74ad7ee9fb302df11f4","title":"ElevenLabs Music Provider Guide","url":"/docs/getting-started/providers/elevenlabs-music","content":"ElevenLabs Music Provider Guide\n\nMusic + sound-effect generation via the ElevenLabs Music / SFX API\n\nOverview\n\nElevenLabs ships music and sound-effect models\nunder the same account used for TTS. NeuroLink supports both via\n (full musical tracks) and\n (short SFX).\n\nKey Facts\nEndpoint:  (and )\nAuth:  header (same key as TTS)\nOutput: MP3\n\nQuick Start\nGet an API Key\n\nhttps://elevenlabs.io/app/settings/api-keys\nConfigure\nGenerate Music\n\nSound Effects\n\nCLI Usage\n\nConfiguration Reference\n\n| Environment Variable | Required | Description    |\n| -------------------- | -------- | -------------- |\n|  | Yes      | ElevenLabs key |\n\nTroubleshooting\n— your ElevenLabs subscription has an open\n  invoice. Complete payment at\n  https://elevenlabs.io/app/subscription\n  to re-enable the music endpoint.\n\nSee Also\nBeatoven Provider\nLyria Provider\nElevenLabs TTS","hierarchy":{"lvl0":"Getting Started","lvl1":"ElevenLabs Music Provider Guide","lvl2":"","lvl3":""}},
 {"objectID":"c53d01db44f92cdf3d96fda02e6105b3c436689e2b09c49cc9819592771f88d0","title":"ElevenLabs Music Provider Guide","url":"/docs/getting-started/providers/elevenlabs-music#elevenlabs-music-provider-guide","content":"Music + sound-effect generation via the ElevenLabs Music / SFX API","hierarchy":{"lvl0":"Getting Started","lvl1":"ElevenLabs Music Provider Guide","lvl2":"ElevenLabs Music Provider Guide","lvl3":""}},
@@ -5739,10 +5739,10 @@
 {"objectID":"9710ca23dde49d00ee877f62b756ee4c472f2a6c1d230e0a0d700931560a83f7","title":"1. Get an API Key + Avatar ID","url":"/docs/getting-started/providers/heygen#1-get-an-api-key-avatar-id","content":"https://app.heygen.com/settings/api\nand pick an avatar id from your avatar library.","hierarchy":{"lvl0":"Getting Started","lvl1":"HeyGen Provider Guide (avatar)","lvl2":"1. Get an API Key + Avatar ID","lvl3":""}},
 {"objectID":"03bd379139540be2918426afee50ad01085ab0a3a64d71c3e75eba88fa41d2e3","title":"Configuration Reference","url":"/docs/getting-started/providers/heygen#configuration-reference","content":"| Environment Variable    | Required | Description                      |\n| ----------------------- | -------- | -------------------------------- |\n|         | Yes      | HeyGen API key                   |\n|  | No       | Optional avatar id for test runs |","hierarchy":{"lvl0":"Getting Started","lvl1":"HeyGen Provider Guide (avatar)","lvl2":"Configuration Reference","lvl3":""}},
 {"objectID":"c050dccfcf76a2f74e8b429184d2033de03ced28b5d675e3806d266d956ad5dc","title":"See Also","url":"/docs/getting-started/providers/heygen#see-also","content":"D-ID Provider\nMuseTalk via Replicate","hierarchy":{"lvl0":"Getting Started","lvl1":"HeyGen Provider Guide (avatar)","lvl2":"See Also","lvl3":""}},
-{"objectID":"3626bbbf9617154292dcf29cc7e93049e111bf5d19b8718befef912a346d11e5","title":"Hugging Face Provider Guide","url":"/docs/getting-started/providers/huggingface","content":"Hugging Face Provider Guide\n\nAccess 100,000+ open-source AI models through Hugging Face's free inference API\n\nOverview\n\nHugging Face is the world's largest platform for open-source AI models, hosting over 100,000 models spanning text generation, code generation, translation, summarization, and more. NeuroLink's Hugging Face provider gives you free access to this vast ecosystem through a unified interface.\n\nHugging Face's inference API is completely free for most models, with a generous daily cap (~1,000 requests/day per model). Perfect for development, testing, and low-to-medium production workloads without any cost concerns.\n\nKey Benefits\n🆓 Free Access: No API costs - completely free to use\n🌍 100,000+ Models: Largest collection of open-source models\n🔓 Open Source: All models are open and transparent\n⚡ Quick Start: No credit card required\n🎯 Specialized Models: Models fine-tuned for specific tasks\n🔬 Research-Friendly: Access to latest research models\n\nUse Cases\nExperimentation: Try different models without cost concerns\nResearch: Access cutting-edge research models\nBudget-Constrained: Production usage without API costs\nSpecialized Tasks: Fine-tuned models for specific domains\nLearning: Perfect for students and developers learning AI\n\nQuick Start\nGet Your API Token\nVisit Hugging Face\nCreate a free account (no credit card required)\nGo to Settings → Access Tokens\nClick \"New token\"\nGive it a name (e.g., \"NeuroLink\")\nSelect \"Read\" permissions\nCopy the token (starts with )\nConfigure NeuroLink\n\nAdd to your  file:\n\nNever commit your API token to version control. Always use environment variables and add  to your  file.\n\nTest the Setup\n\nModel Selection Guide\n\nPopular Models by Category\nGeneral Text Generation\n\n| Model                                           | Size    | Description                          | Best For                        |\n| ----------------------------------------------- | ------- | ------------------------------------ | ------------------------------- |\n|                      | 72B     | Qwen 2.5 instruction-tuned (default) | General tasks, high quality     |\n|                           | 235B    | Latest Qwen 3 MoE flagship           | Complex reasoning, multilingual |\n|                                 | 32B     | Qwen 3 dense model                   | Balanced quality and speed      |\n|                                  | 8B      | Qwen 3 efficient model               | Fast responses, low cost        |\n|              | 70B     | Meta Llama 3.3 instruction-tuned     | Conversational AI, reasoning    |\n|      | 17B MoE | Meta Llama 4 Scout                   | Efficient multimodal tasks      |\n|  | 17B MoE | Meta Llama 4 Maverick                | Advanced multimodal reasoning   |\n|                        | 671B    | DeepSeek reasoning model             | Math, logic, step-by-step       |\n|                   | 671B    | DeepSeek V3 general-purpose          | General tasks, coding           |\n|                   | 123B    | Mistral Large 3                      | Enterprise, multilingual        |\n|       | 24B     | Mistral Small 3.1                    | Fast, cost-effective            |\n|                          | 27B     | Google Gemma 3 instruction-tuned     | General tasks, research         |\n|                          | 12B     | Google Gemma 3 mid-size              | Balanced performance            |\n|                           | 4B      | Google Gemma 3 lightweight           | Edge deployment, fast           |\n|                                | 14B     | Microsoft Phi-4                      | Reasoning, STEM tasks           |\n|                  | 3.8B    | Microsoft Phi-4-mini                 | Lightweight, on-device          |\nCode Generation\n\n| Model                               | Description                       | Best For               |\n| ----------------------------------- | --------------------------------- | ---------------------- |\n|      | Mistral Devstral 2 code model     | Code generation, IDE   |\n|    | Qwen 2.5 code specialist          | Complex coding tasks   |\n|       | DeepSeek V3 with strong code perf | Full-stack development |\n|  | Llama 3.3 with code capabilities  | Code review, refactor  |\nSummarization\n\n| Model                     | Description               | Best For             |\n| ------------------------- | ------------------------- | -------------------- |\n|  | News summarization        | Articles, news       |\n|            | Qwen 3 with summarization | General summaries    |\n|      | Extreme summarization     | Very brief summaries |\nTranslation\n\n| Model                                      | Languages      | Best For                   |\n| ------------------------------------------ | -------------- | -------------------------- |\n|  | 50 languages   | Multi-language translation |\n|                    | Language pairs | Specific language pairs    |\nQuestion Answering\n\n| Model                         | Description         | Best For       |\n| -----------------","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"","lvl3":""}},
-{"objectID":"67c35fed652c61cb9ecef3da50aa08ebb87bdc39a1535b300e13cf06b7bf9ada","title":"Hugging Face Provider Guide","url":"/docs/getting-started/providers/huggingface#hugging-face-provider-guide","content":"Access 100,000+ open-source AI models through Hugging Face's free inference API","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"Hugging Face Provider Guide","lvl3":""}},
-{"objectID":"bb7532acf343b5ec394b96896488e4c683978e28eb82d921823a453823913723","title":"Overview","url":"/docs/getting-started/providers/huggingface#overview","content":"Hugging Face is the world's largest platform for open-source AI models, hosting over 100,000 models spanning text generation, code generation, translation, summarization, and more. NeuroLink's Hugging Face provider gives you free access to this vast ecosystem through a unified interface.\n\nHugging Face's inference API is completely free for most models, with a generous daily cap (~1,000 requests/day per model). Perfect for development, testing, and low-to-medium production workloads without any cost concerns.","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"Overview","lvl3":""}},
-{"objectID":"24c6946aad4b2220bd47c9405e322a983cda7f8cb51ca80bcf137565d6e1434b","title":"Key Benefits","url":"/docs/getting-started/providers/huggingface#key-benefits","content":"🆓 Free Access: No API costs - completely free to use\n🌍 100,000+ Models: Largest collection of open-source models\n🔓 Open Source: All models are open and transparent\n⚡ Quick Start: No credit card required\n🎯 Specialized Models: Models fine-tuned for specific tasks\n🔬 Research-Friendly: Access to latest research models","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"Key Benefits","lvl3":""}},
+{"objectID":"3626bbbf9617154292dcf29cc7e93049e111bf5d19b8718befef912a346d11e5","title":"Hugging Face Provider Guide","url":"/docs/getting-started/providers/huggingface","content":"Hugging Face Provider Guide\n\nAccess open-source AI models through Hugging Face Inference Providers\n\nOverview\n\nHugging Face is the world's largest platform for open-source AI models, hosting over 100,000 models spanning text generation, code generation, translation, summarization, and more. NeuroLink's Hugging Face provider reaches the chat models the Inference Providers router serves, through a unified interface.\n\nFree accounts get a small monthly credit for Inference Providers, with no card required (pricing). Once it is spent, requests return  until you buy pre-paid credits or subscribe to PRO.\n\nKey Benefits\n🆓 Free Credits: A small monthly allowance to start with\n🌍 100,000+ Models: Largest collection of open-source models\n🔓 Open Source: All models are open and transparent\n⚡ Quick Start: No credit card required\n🎯 Specialized Models: Models fine-tuned for specific tasks\n🔬 Research-Friendly: Access to latest research models\n\nUse Cases\nExperimentation: Try different models without cost concerns\nResearch: Access cutting-edge research models\nBudget-Constrained: Production usage without API costs\nSpecialized Tasks: Fine-tuned models for specific domains\nLearning: Perfect for students and developers learning AI\n\nQuick Start\nGet Your API Token\nVisit Hugging Face\nCreate a free account (no credit card required)\nGo to Settings → Access Tokens\nClick \"New token\"\nGive it a name (e.g., \"NeuroLink\")\nSelect \"Read\" permissions\nCopy the token (starts with )\nConfigure NeuroLink\n\nAdd to your  file:\n\nNever commit your API token to version control. Always use environment variables and add  to your  file.\n\nTest the Setup\n\nModel Selection Guide\n\nPopular Models by Category\nGeneral Text Generation\n\n| Model                                       | Size    | Description                          | Best For                        |\n| ------------------------------------------- | ------- | ------------------------------------ | ------------------------------- |\n|                  | 72B     | Qwen 2.5 instruction-tuned (default) | General tasks, high quality     |\n|                       | 235B    | Latest Qwen 3 MoE flagship           | Complex reasoning, multilingual |\n|                             | 32B     | Qwen 3 dense model                   | Balanced quality and speed      |\n|                              | 8B      | Qwen 3 efficient model               | Fast responses, low cost        |\n|          | 70B     | Meta Llama 3.3 instruction-tuned     | Conversational AI, reasoning    |\n|  | 17B MoE | Meta Llama 4 Scout                   | Efficient multimodal tasks      |\n|                    | 671B    | DeepSeek reasoning model             | Math, logic, step-by-step       |\n|               | 671B    | DeepSeek V3 general-purpose          | General tasks, coding           |\n|                      | 27B     | Google Gemma 3 instruction-tuned     | General tasks, research         |\n|                      | 12B     | Google Gemma 3 mid-size              | Balanced performance            |\n|                       | 4B      | Google Gemma 3 lightweight           | Edge deployment, fast           |\n|                            | 14B     | Microsoft Phi-4                      | Reasoning, STEM tasks           |\nCode Generation\n\n| Model                               | Description                       | Best For               |\n| ----------------------------------- | --------------------------------- | ---------------------- |\n|    | Qwen 2.5 code specialist          | Complex coding tasks   |\n|       | DeepSeek V3 with strong code perf | Full-stack development |\n|  | Llama 3.3 with code capabilities  | Code review, refactor  |\nSummarization\n\n| Model                     | Description               | Best For             |\n| ------------------------- | ------------------------- | -------------------- |\n|  | News summarization        | Articles, news       |\n|            | Qwen 3 with summarization | General summaries    |\n|      | Extreme summarization     | Very brief summaries |\nTranslation\n\n| Model                                      | Languages      | Best For                   |\n| ------------------------------------------ | -------------- | -------------------------- |\n|  | 50 languages   | Multi-language translation |\n|                    | Language pairs | Specific language pairs    |\nQuestion Answering\n\n| Model                         | Description         | Best For       |\n| ----------------------------- | ------------------- | -------------- |\n|  | SQuAD-trained       | Factual Q&A    |\n|    | General QA via chat | Open-ended Q&A |\n\nModel Selection by Use Case\n\nFree Tier Details\n\nWhat's Included\n✅ Monthly credits for Inference Providers on a free account\n✅ No credit card required for the free credits\n⚠️  once the credits are spent — buy pre-paid credits or subscribe to PRO to continue\n\nSee Hugging Face's pricing page for the current allowance.\n\nSpending the credits\nBest Practice: Combine with other providers so a spent allo","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"","lvl3":""}},
+{"objectID":"67c35fed652c61cb9ecef3da50aa08ebb87bdc39a1535b300e13cf06b7bf9ada","title":"Hugging Face Provider Guide","url":"/docs/getting-started/providers/huggingface#hugging-face-provider-guide","content":"Access open-source AI models through Hugging Face Inference Providers","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"Hugging Face Provider Guide","lvl3":""}},
+{"objectID":"bb7532acf343b5ec394b96896488e4c683978e28eb82d921823a453823913723","title":"Overview","url":"/docs/getting-started/providers/huggingface#overview","content":"Hugging Face is the world's largest platform for open-source AI models, hosting over 100,000 models spanning text generation, code generation, translation, summarization, and more. NeuroLink's Hugging Face provider reaches the chat models the Inference Providers router serves, through a unified interface.\n\nFree accounts get a small monthly credit for Inference Providers, with no card required (pricing). Once it is spent, requests return  until you buy pre-paid credits or subscribe to PRO.","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"Overview","lvl3":""}},
+{"objectID":"24c6946aad4b2220bd47c9405e322a983cda7f8cb51ca80bcf137565d6e1434b","title":"Key Benefits","url":"/docs/getting-started/providers/huggingface#key-benefits","content":"🆓 Free Credits: A small monthly allowance to start with\n🌍 100,000+ Models: Largest collection of open-source models\n🔓 Open Source: All models are open and transparent\n⚡ Quick Start: No credit card required\n🎯 Specialized Models: Models fine-tuned for specific tasks\n🔬 Research-Friendly: Access to latest research models","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"Key Benefits","lvl3":""}},
 {"objectID":"892c972b4296de1f969a0863b637ddec5d582e505766497ed926c53dd5525298","title":"Use Cases","url":"/docs/getting-started/providers/huggingface#use-cases","content":"Experimentation: Try different models without cost concerns\nResearch: Access cutting-edge research models\nBudget-Constrained: Production usage without API costs\nSpecialized Tasks: Fine-tuned models for specific domains\nLearning: Perfect for students and developers learning AI","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"Use Cases","lvl3":""}},
 {"objectID":"428b66beca8e247085d1be01098189fcfa8ec8c9d1ef1cf6d13571026dd255c9","title":"1. Get Your API Token","url":"/docs/getting-started/providers/huggingface#1-get-your-api-token","content":"Visit Hugging Face\nCreate a free account (no credit card required)\nGo to Settings → Access Tokens\nClick \"New token\"\nGive it a name (e.g., \"NeuroLink\")\nSelect \"Read\" permissions\nCopy the token (starts with )","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"1. Get Your API Token","lvl3":""}},
 {"objectID":"39d4fd9b5b74c321a8a036e4f691f5e858ad47d585b25d8d2bcfa45391bf9783","title":"2. Configure NeuroLink","url":"/docs/getting-started/providers/huggingface#2-configure-neurolink","content":"Add to your  file:\n\nNever commit your API token to version control. Always use environment variables and add  to your  file.","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"2. Configure NeuroLink","lvl3":""}},
@@ -5750,13 +5750,13 @@
 {"objectID":"83d34974023436cb86b92310e4ee3d61e43dc90681f32af73fe2d9c98c0e460f","title":"CLI - Test with default model","url":"/docs/getting-started/providers/huggingface#cli---test-with-default-model","content":"npx @juspay/neurolink generate \"Hello from Hugging Face!\" --provider huggingface","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"CLI - Test with default model","lvl3":""}},
 {"objectID":"d4070a93ff93c72be68ecba469c0213a8175c449243cd6df6bcb39852ddd4881","title":"CLI - Use specific model","url":"/docs/getting-started/providers/huggingface#cli---use-specific-model","content":"npx @juspay/neurolink generate \"Write a poem\" --provider huggingface --model \"Qwen/Qwen2.5-72B-Instruct\"","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"CLI - Use specific model","lvl3":""}},
 {"objectID":"c410b97167de4919ed583e78929abe7935d2f9b30aec33f3e0dd536595a477a0","title":"SDK","url":"/docs/getting-started/providers/huggingface#sdk","content":"node -e \"\nconst { NeuroLink } = require('@juspay/neurolink');\n(async () => {\n  const ai = new NeuroLink();\n  const result = await ai.generate({\n    input: { text: 'Hello from Hugging Face!' },\n    provider: 'huggingface'\n  });\n  console.log(result.content);\n})();\n\"\n`","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"SDK","lvl3":""}},
-{"objectID":"8d11d199a6f188ccade2c0c0354d64bae5832aa7f8ebb400adddd12c65c66391","title":"1. General Text Generation","url":"/docs/getting-started/providers/huggingface#1-general-text-generation","content":"| Model                                           | Size    | Description                          | Best For                        |\n| ----------------------------------------------- | ------- | ------------------------------------ | ------------------------------- |\n|                      | 72B     | Qwen 2.5 instruction-tuned (default) | General tasks, high quality     |\n|                           | 235B    | Latest Qwen 3 MoE flagship           | Complex reasoning, multilingual |\n|                                 | 32B     | Qwen 3 dense model                   | Balanced quality and speed      |\n|                                  | 8B      | Qwen 3 efficient model               | Fast responses, low cost        |\n|              | 70B     | Meta Llama 3.3 instruction-tuned     | Conversational AI, reasoning    |\n|      | 17B MoE | Meta Llama 4 Scout                   | Efficient multimodal tasks      |\n|  | 17B MoE | Meta Llama 4 Maverick                | Advanced multimodal reasoning   |\n|                        | 671B    | DeepSeek reasoning model             | Math, logic, step-by-step       |\n|                   | 671B    | DeepSeek V3 general-purpose          | General tasks, coding           |\n|                   | 123B    | Mistral Large 3                      | Enterprise, multilingual        |\n|       | 24B     | Mistral Small 3.1                    | Fast, cost-effective            |\n|                          | 27B     | Google Gemma 3 instruction-tuned     | General tasks, research         |\n|                          | 12B     | Google Gemma 3 mid-size              | Balanced performance            |\n|                           | 4B      | Google Gemma 3 lightweight           | Edge deployment, fast           |\n|                                | 14B     | Microsoft Phi-4                      | Reasoning, STEM tasks           |\n|                  | 3.8B    | Microsoft Phi-4-mini                 | Lightweight, on-device          |","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"1. General Text Generation","lvl3":""}},
-{"objectID":"2ed33a7debf4478aa4375a920a2a7fff96130d3809027b7f5506f1c7637f82ba","title":"2. Code Generation","url":"/docs/getting-started/providers/huggingface#2-code-generation","content":"| Model                               | Description                       | Best For               |\n| ----------------------------------- | --------------------------------- | ---------------------- |\n|      | Mistral Devstral 2 code model     | Code generation, IDE   |\n|    | Qwen 2.5 code specialist          | Complex coding tasks   |\n|       | DeepSeek V3 with strong code perf | Full-stack development |\n|  | Llama 3.3 with code capabilities  | Code review, refactor  |","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"2. Code Generation","lvl3":""}},
+{"objectID":"8d11d199a6f188ccade2c0c0354d64bae5832aa7f8ebb400adddd12c65c66391","title":"1. General Text Generation","url":"/docs/getting-started/providers/huggingface#1-general-text-generation","content":"| Model                                       | Size    | Description                          | Best For                        |\n| ------------------------------------------- | ------- | ------------------------------------ | ------------------------------- |\n|                  | 72B     | Qwen 2.5 instruction-tuned (default) | General tasks, high quality     |\n|                       | 235B    | Latest Qwen 3 MoE flagship           | Complex reasoning, multilingual |\n|                             | 32B     | Qwen 3 dense model                   | Balanced quality and speed      |\n|                              | 8B      | Qwen 3 efficient model               | Fast responses, low cost        |\n|          | 70B     | Meta Llama 3.3 instruction-tuned     | Conversational AI, reasoning    |\n|  | 17B MoE | Meta Llama 4 Scout                   | Efficient multimodal tasks      |\n|                    | 671B    | DeepSeek reasoning model             | Math, logic, step-by-step       |\n|               | 671B    | DeepSeek V3 general-purpose          | General tasks, coding           |\n|                      | 27B     | Google Gemma 3 instruction-tuned     | General tasks, research         |\n|                      | 12B     | Google Gemma 3 mid-size              | Balanced performance            |\n|                       | 4B      | Google Gemma 3 lightweight           | Edge deployment, fast           |\n|                            | 14B     | Microsoft Phi-4                      | Reasoning, STEM tasks           |","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"1. General Text Generation","lvl3":""}},
+{"objectID":"2ed33a7debf4478aa4375a920a2a7fff96130d3809027b7f5506f1c7637f82ba","title":"2. Code Generation","url":"/docs/getting-started/providers/huggingface#2-code-generation","content":"| Model                               | Description                       | Best For               |\n| ----------------------------------- | --------------------------------- | ---------------------- |\n|    | Qwen 2.5 code specialist          | Complex coding tasks   |\n|       | DeepSeek V3 with strong code perf | Full-stack development |\n|  | Llama 3.3 with code capabilities  | Code review, refactor  |","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"2. Code Generation","lvl3":""}},
 {"objectID":"80224b192cb527fa812447cd3396646b235b684262219a6b8e0a8aeb334aea6a","title":"3. Summarization","url":"/docs/getting-started/providers/huggingface#3-summarization","content":"| Model                     | Description               | Best For             |\n| ------------------------- | ------------------------- | -------------------- |\n|  | News summarization        | Articles, news       |\n|            | Qwen 3 with summarization | General summaries    |\n|      | Extreme summarization     | Very brief summaries |","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"3. Summarization","lvl3":""}},
 {"objectID":"076533ffa91fd4afccbcd703b43e4ebbb6a847985094e68517a9d0ab3a01223a","title":"4. Translation","url":"/docs/getting-started/providers/huggingface#4-translation","content":"| Model                                      | Languages      | Best For                   |\n| ------------------------------------------ | -------------- | -------------------------- |\n|  | 50 languages   | Multi-language translation |\n|                    | Language pairs | Specific language pairs    |","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"4. Translation","lvl3":""}},
 {"objectID":"f4d2cfd0932d165e62bfb64da9167def25b8dca05ed8fa8c2612e8f47064b8cd","title":"5. Question Answering","url":"/docs/getting-started/providers/huggingface#5-question-answering","content":"| Model                         | Description         | Best For       |\n| ----------------------------- | ------------------- | -------------- |\n|  | SQuAD-trained       | Factual Q&A    |\n|    | General QA via chat | Open-ended Q&A |","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"5. Question Answering","lvl3":""}},
-{"objectID":"6053679d453ed2df9e4387155140cd286640877390b3b2061b2c681cb314f5a1","title":"What's Included","url":"/docs/getting-started/providers/huggingface#whats-included","content":"✅ Unlimited requests to public models\n✅ No cost - completely free\n✅ No credit card required\n✅ Rate limits: 1,000 requests/day per model (generous)\n✅ Access to 100,000+ public models","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"What's Included","lvl3":""}},
-{"objectID":"996143ffa82427de6586df5fce6d7b475019a22e09208a48c6351426e3acd3af","title":"Rate Limits","url":"/docs/getting-started/providers/huggingface#rate-limits","content":"Per Model: ~1,000 requests/day\nStrategy: Use different models to scale\nBest Practice: Combine with other providers for production","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"Rate Limits","lvl3":""}},
+{"objectID":"6053679d453ed2df9e4387155140cd286640877390b3b2061b2c681cb314f5a1","title":"What's Included","url":"/docs/getting-started/providers/huggingface#whats-included","content":"✅ Monthly credits for Inference Providers on a free account\n✅ No credit card required for the free credits\n⚠️  once the credits are spent — buy pre-paid credits or subscribe to PRO to continue\n\nSee Hugging Face's pricing page for the current allowance.","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"What's Included","lvl3":""}},
+{"objectID":"38e1606ed1185a8b86d7dfc53fb8de561d8e08a5761caba52fe1197bc28baed1","title":"Spending the credits","url":"/docs/getting-started/providers/huggingface#spending-the-credits","content":"Best Practice: Combine with other providers so a spent allowance falls back instead of failing","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"Spending the credits","lvl3":""}},
 {"objectID":"7daac646e85d818c28199cd00f6b09f1444f8f9960da484a7dad1c1a0854cfcb","title":"Limitations","url":"/docs/getting-started/providers/huggingface#limitations","content":"⚠️ Free Tier Constraints:\nModels load on-demand (first request may be slow)\nRate limits per model (use multiple models to scale)\nNo guaranteed uptime (community infrastructure)\nSome popular models may have queues\n\n💡 For Production:\nUse Hugging Face for experimentation\nConsider paid inference for critical workloads\nCombine with other providers for reliability","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"Limitations","lvl3":""}},
 {"objectID":"d4714bef1962c63a0986dff017d6f3f2b5f10611c54e6bad08501909c17192f8","title":"Basic Commands","url":"/docs/getting-started/providers/huggingface#basic-commands","content":"`bash","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"Basic Commands","lvl3":""}},
 {"objectID":"6faa84aa14c65d4f3e18552e8cbe84862da1f30415b5371d028dbc87ca2f821a","title":"Generate with default model","url":"/docs/getting-started/providers/huggingface#generate-with-default-model","content":"npx @juspay/neurolink generate \"Hello world\" --provider huggingface","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"Generate with default model","lvl3":""}},
@@ -5774,7 +5774,7 @@
 {"objectID":"c8bed242b8dc9d39c4faba0cd9b5ac30502ad89c18edce76976db9027e4b82c4","title":"Optional","url":"/docs/getting-started/providers/huggingface#optional","content":"HUGGINGFACEBASEURL=https://api-inference.huggingface.co  # Custom endpoint\nHUGGINGFACE_MODEL=Qwen/Qwen2.5-72B-Instruct  # Default model\nHUGGINGFACE_TIMEOUT=60000  # Request timeout (ms)\n`","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"Optional","lvl3":""}},
 {"objectID":"0c7c8b4331824fac971cf656bcd4461c4bd7c847f320990518b52367c8b13fff","title":"1. \"Model is currently loading\"","url":"/docs/getting-started/providers/huggingface#1-model-is-currently-loading","content":"Problem: Model hasn't been used recently and needs to load.\n\nSolution:\n\n`bash","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"1. \"Model is currently loading\"","lvl3":""}},
 {"objectID":"ba47758f6823477832a27157519d88f01208147b5a61289a37b44aae5b59a9f6","title":"Or use a popular model that's always loaded","url":"/docs/getting-started/providers/huggingface#or-use-a-popular-model-thats-always-loaded","content":"npx @juspay/neurolink gen \"test\" \\\n  --provider huggingface \\\n  --model \"Qwen/Qwen2.5-72B-Instruct\"\n`","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"Or use a popular model that's always loaded","lvl3":""}},
-{"objectID":"f61d2d759b6546b436af5efa7532a9f27bf1e7e97a3ea7e55d881330753d18de","title":"2. \"Rate limit exceeded\"","url":"/docs/getting-started/providers/huggingface#2-rate-limit-exceeded","content":"Problem: Hit the ~1,000 requests/day limit for a model.\n\nSolution:","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"2. \"Rate limit exceeded\"","lvl3":""}},
+{"objectID":"f61d2d759b6546b436af5efa7532a9f27bf1e7e97a3ea7e55d881330753d18de","title":"2. \"Rate limit exceeded\"","url":"/docs/getting-started/providers/huggingface#2-rate-limit-exceeded","content":"Problem: Too many requests in a short window. A  instead means the monthly credits are spent — see Free credits.\n\nSolution:","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"2. \"Rate limit exceeded\"","lvl3":""}},
 {"objectID":"01f04aad378dde52be217fdc59156db563895a2ae7f10ca8c61be9c83273488f","title":"3. \"Invalid API token\"","url":"/docs/getting-started/providers/huggingface#3-invalid-api-token","content":"Problem: Token is incorrect or expired.\n\nSolution:\nVerify token at https://huggingface.co/settings/tokens\nEnsure token has \"Read\" permissions\nCheck for typos in  file\nToken should start with","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"3. \"Invalid API token\"","lvl3":""}},
 {"objectID":"315d6ab62dd10392cef05eeea570be85c59491fd75bc0a1e32e3d8ffe3b13cd1","title":"4. \"Model not found\"","url":"/docs/getting-started/providers/huggingface#4-model-not-found","content":"Problem: Model name is incorrect or private.\n\nSolution:\n\n`bash","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"4. \"Model not found\"","lvl3":""}},
 {"objectID":"4637726f641340ec3203ff72886bedbe807db7d8c36cf9e1e02813859e571ac2","title":"Use exact model ID: username/model-name","url":"/docs/getting-started/providers/huggingface#use-exact-model-id-usernamemodel-name","content":"npx @juspay/neurolink gen \"test\" \\\n  --provider huggingface \\\n  --model \"Qwen/Qwen2.5-72B-Instruct\"  # ✅ Correct format\n`","hierarchy":{"lvl0":"Getting Started","lvl1":"Hugging Face Provider Guide","lvl2":"Use exact model ID: username/model-name","lvl3":""}},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "12.25.0",
+  "version": "12.25.2",
   "packageManager": "pnpm@10.15.1",
   "description": "The pipe layer of an AI nervous system: one interface connecting provider neurons to your application, across three inference types — generate, stream and decide. `decide` returns typed, calibrated judgements from a non-generative model (~400ms, ~$0.00002/call) for routing, tool selection and context budgeting. MCP-native (4 transports), voice TTS/STT/realtime, RAG, agents, memory, compaction, 9 observability exporters. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · TypeSafe Jev and more.",
   "author": {