@mastra/mcp-docs-server 1.1.5 → 1.1.6-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (556) hide show
  1. package/.docs/docs/agents/adding-voice.md +349 -0
  2. package/.docs/docs/agents/agent-approval.md +558 -0
  3. package/.docs/docs/agents/agent-memory.md +209 -0
  4. package/.docs/docs/agents/guardrails.md +374 -0
  5. package/.docs/docs/agents/network-approval.md +275 -0
  6. package/.docs/docs/agents/networks.md +299 -0
  7. package/.docs/docs/agents/overview.md +304 -0
  8. package/.docs/docs/agents/processors.md +622 -0
  9. package/.docs/docs/agents/structured-output.md +273 -0
  10. package/.docs/docs/agents/supervisor-agents.md +304 -0
  11. package/.docs/docs/agents/using-tools.md +214 -0
  12. package/.docs/docs/build-with-ai/mcp-docs-server.md +238 -0
  13. package/.docs/docs/build-with-ai/skills.md +35 -0
  14. package/.docs/docs/community/contributing-templates.md +3 -0
  15. package/.docs/docs/community/discord.md +9 -0
  16. package/.docs/docs/community/licensing.md +66 -0
  17. package/.docs/docs/deployment/cloud-providers.md +15 -0
  18. package/.docs/docs/deployment/mastra-server.md +122 -0
  19. package/.docs/docs/deployment/monorepo.md +142 -0
  20. package/.docs/docs/deployment/overview.md +62 -0
  21. package/.docs/docs/deployment/studio.md +239 -0
  22. package/.docs/docs/deployment/web-framework.md +52 -0
  23. package/.docs/docs/deployment/workflow-runners.md +9 -0
  24. package/.docs/docs/evals/built-in-scorers.md +47 -0
  25. package/.docs/docs/evals/custom-scorers.md +519 -0
  26. package/.docs/docs/evals/overview.md +141 -0
  27. package/.docs/docs/evals/running-in-ci.md +124 -0
  28. package/.docs/docs/getting-started/build-with-ai.md +68 -0
  29. package/.docs/docs/getting-started/manual-install.md +226 -0
  30. package/.docs/docs/getting-started/project-structure.md +60 -0
  31. package/.docs/docs/getting-started/start.md +28 -0
  32. package/.docs/docs/getting-started/studio.md +101 -0
  33. package/.docs/docs/index.md +43 -0
  34. package/.docs/docs/mastra-cloud/deployment.md +77 -0
  35. package/.docs/docs/mastra-cloud/observability.md +38 -0
  36. package/.docs/docs/mastra-cloud/overview.md +23 -0
  37. package/.docs/docs/mastra-cloud/setup.md +42 -0
  38. package/.docs/docs/mastra-cloud/studio.md +24 -0
  39. package/.docs/docs/mastra-code/configuration.md +299 -0
  40. package/.docs/docs/mastra-code/customization.md +228 -0
  41. package/.docs/docs/mastra-code/modes.md +104 -0
  42. package/.docs/docs/mastra-code/overview.md +135 -0
  43. package/.docs/docs/mastra-code/tools.md +229 -0
  44. package/.docs/docs/mcp/overview.md +373 -0
  45. package/.docs/docs/mcp/publishing-mcp-server.md +95 -0
  46. package/.docs/docs/memory/memory-processors.md +314 -0
  47. package/.docs/docs/memory/message-history.md +260 -0
  48. package/.docs/docs/memory/observational-memory.md +248 -0
  49. package/.docs/docs/memory/overview.md +45 -0
  50. package/.docs/docs/memory/semantic-recall.md +272 -0
  51. package/.docs/docs/memory/storage.md +261 -0
  52. package/.docs/docs/memory/working-memory.md +400 -0
  53. package/.docs/docs/observability/datasets/overview.md +198 -0
  54. package/.docs/docs/observability/datasets/running-experiments.md +274 -0
  55. package/.docs/docs/observability/logging.md +99 -0
  56. package/.docs/docs/observability/overview.md +70 -0
  57. package/.docs/docs/observability/tracing/bridges/otel.md +209 -0
  58. package/.docs/docs/observability/tracing/exporters/arize.md +272 -0
  59. package/.docs/docs/observability/tracing/exporters/braintrust.md +111 -0
  60. package/.docs/docs/observability/tracing/exporters/cloud.md +127 -0
  61. package/.docs/docs/observability/tracing/exporters/datadog.md +187 -0
  62. package/.docs/docs/observability/tracing/exporters/default.md +209 -0
  63. package/.docs/docs/observability/tracing/exporters/laminar.md +100 -0
  64. package/.docs/docs/observability/tracing/exporters/langfuse.md +213 -0
  65. package/.docs/docs/observability/tracing/exporters/langsmith.md +198 -0
  66. package/.docs/docs/observability/tracing/exporters/otel.md +476 -0
  67. package/.docs/docs/observability/tracing/exporters/posthog.md +148 -0
  68. package/.docs/docs/observability/tracing/exporters/sentry.md +208 -0
  69. package/.docs/docs/observability/tracing/overview.md +1112 -0
  70. package/.docs/docs/observability/tracing/processors/sensitive-data-filter.md +300 -0
  71. package/.docs/docs/rag/chunking-and-embedding.md +183 -0
  72. package/.docs/docs/rag/graph-rag.md +215 -0
  73. package/.docs/docs/rag/overview.md +72 -0
  74. package/.docs/docs/rag/retrieval.md +515 -0
  75. package/.docs/docs/rag/vector-databases.md +645 -0
  76. package/.docs/docs/server/auth/auth0.md +220 -0
  77. package/.docs/docs/server/auth/better-auth.md +203 -0
  78. package/.docs/docs/server/auth/clerk.md +132 -0
  79. package/.docs/docs/server/auth/composite-auth.md +234 -0
  80. package/.docs/docs/server/auth/custom-auth-provider.md +513 -0
  81. package/.docs/docs/server/auth/firebase.md +272 -0
  82. package/.docs/docs/server/auth/jwt.md +110 -0
  83. package/.docs/docs/server/auth/simple-auth.md +180 -0
  84. package/.docs/docs/server/auth/supabase.md +117 -0
  85. package/.docs/docs/server/auth/workos.md +186 -0
  86. package/.docs/docs/server/auth.md +38 -0
  87. package/.docs/docs/server/custom-adapters.md +378 -0
  88. package/.docs/docs/server/custom-api-routes.md +267 -0
  89. package/.docs/docs/server/mastra-client.md +243 -0
  90. package/.docs/docs/server/mastra-server.md +71 -0
  91. package/.docs/docs/server/middleware.md +225 -0
  92. package/.docs/docs/server/request-context.md +471 -0
  93. package/.docs/docs/server/server-adapters.md +547 -0
  94. package/.docs/docs/streaming/events.md +237 -0
  95. package/.docs/docs/streaming/overview.md +175 -0
  96. package/.docs/docs/streaming/tool-streaming.md +175 -0
  97. package/.docs/docs/streaming/workflow-streaming.md +109 -0
  98. package/.docs/docs/voice/overview.md +959 -0
  99. package/.docs/docs/voice/speech-to-speech.md +102 -0
  100. package/.docs/docs/voice/speech-to-text.md +79 -0
  101. package/.docs/docs/voice/text-to-speech.md +83 -0
  102. package/.docs/docs/workflows/agents-and-tools.md +166 -0
  103. package/.docs/docs/workflows/control-flow.md +822 -0
  104. package/.docs/docs/workflows/error-handling.md +360 -0
  105. package/.docs/docs/workflows/human-in-the-loop.md +215 -0
  106. package/.docs/docs/workflows/overview.md +370 -0
  107. package/.docs/docs/workflows/snapshots.md +238 -0
  108. package/.docs/docs/workflows/suspend-and-resume.md +205 -0
  109. package/.docs/docs/workflows/time-travel.md +309 -0
  110. package/.docs/docs/workflows/workflow-state.md +181 -0
  111. package/.docs/docs/workspace/filesystem.md +164 -0
  112. package/.docs/docs/workspace/overview.md +239 -0
  113. package/.docs/docs/workspace/sandbox.md +63 -0
  114. package/.docs/docs/workspace/search.md +243 -0
  115. package/.docs/docs/workspace/skills.md +169 -0
  116. package/.docs/guides/agent-frameworks/ai-sdk.md +140 -0
  117. package/.docs/guides/build-your-ui/ai-sdk-ui.md +1499 -0
  118. package/.docs/guides/build-your-ui/assistant-ui.md +156 -0
  119. package/.docs/guides/build-your-ui/copilotkit.md +289 -0
  120. package/.docs/guides/deployment/amazon-ec2.md +130 -0
  121. package/.docs/guides/deployment/aws-lambda.md +248 -0
  122. package/.docs/guides/deployment/azure-app-services.md +114 -0
  123. package/.docs/guides/deployment/cloudflare.md +99 -0
  124. package/.docs/guides/deployment/digital-ocean.md +168 -0
  125. package/.docs/guides/deployment/inngest.md +682 -0
  126. package/.docs/guides/deployment/netlify.md +77 -0
  127. package/.docs/guides/deployment/vercel.md +101 -0
  128. package/.docs/guides/getting-started/astro.md +398 -0
  129. package/.docs/guides/getting-started/electron.md +504 -0
  130. package/.docs/guides/getting-started/express.md +251 -0
  131. package/.docs/guides/getting-started/hono.md +190 -0
  132. package/.docs/guides/getting-started/next-js.md +347 -0
  133. package/.docs/guides/getting-started/nuxt.md +497 -0
  134. package/.docs/guides/getting-started/quickstart.md +67 -0
  135. package/.docs/guides/getting-started/sveltekit.md +296 -0
  136. package/.docs/guides/getting-started/vite-react.md +425 -0
  137. package/.docs/guides/guide/ai-recruiter.md +226 -0
  138. package/.docs/guides/guide/chef-michel.md +211 -0
  139. package/.docs/guides/guide/code-review-bot.md +226 -0
  140. package/.docs/guides/guide/dev-assistant.md +307 -0
  141. package/.docs/guides/guide/docs-manager.md +238 -0
  142. package/.docs/guides/guide/github-actions-pr-description.md +236 -0
  143. package/.docs/guides/guide/notes-mcp-server.md +416 -0
  144. package/.docs/guides/guide/research-assistant.md +348 -0
  145. package/.docs/guides/guide/research-coordinator.md +416 -0
  146. package/.docs/guides/guide/stock-agent.md +132 -0
  147. package/.docs/guides/guide/web-search.md +320 -0
  148. package/.docs/guides/guide/whatsapp-chat-bot.md +405 -0
  149. package/.docs/guides/index.md +3 -0
  150. package/.docs/guides/migrations/agentnetwork.md +97 -0
  151. package/.docs/guides/migrations/ai-sdk-v4-to-v5.md +112 -0
  152. package/.docs/guides/migrations/network-to-supervisor.md +261 -0
  153. package/.docs/guides/migrations/upgrade-to-v1/agent.md +404 -0
  154. package/.docs/guides/migrations/upgrade-to-v1/cli.md +57 -0
  155. package/.docs/guides/migrations/upgrade-to-v1/client.md +337 -0
  156. package/.docs/guides/migrations/upgrade-to-v1/deployment.md +37 -0
  157. package/.docs/guides/migrations/upgrade-to-v1/evals.md +239 -0
  158. package/.docs/guides/migrations/upgrade-to-v1/mastra.md +143 -0
  159. package/.docs/guides/migrations/upgrade-to-v1/mcp.md +97 -0
  160. package/.docs/guides/migrations/upgrade-to-v1/memory.md +285 -0
  161. package/.docs/guides/migrations/upgrade-to-v1/overview.md +119 -0
  162. package/.docs/guides/migrations/upgrade-to-v1/processors.md +68 -0
  163. package/.docs/guides/migrations/upgrade-to-v1/rag.md +42 -0
  164. package/.docs/guides/migrations/upgrade-to-v1/storage.md +553 -0
  165. package/.docs/guides/migrations/upgrade-to-v1/tools.md +180 -0
  166. package/.docs/guides/migrations/upgrade-to-v1/tracing.md +412 -0
  167. package/.docs/guides/migrations/upgrade-to-v1/vectors.md +87 -0
  168. package/.docs/guides/migrations/upgrade-to-v1/voice.md +30 -0
  169. package/.docs/guides/migrations/upgrade-to-v1/workflows.md +341 -0
  170. package/.docs/guides/migrations/vnext-to-standard-apis.md +362 -0
  171. package/.docs/models/embeddings.md +161 -0
  172. package/.docs/models/gateways/azure-openai.md +128 -0
  173. package/.docs/models/gateways/custom-gateways.md +545 -0
  174. package/.docs/models/gateways/netlify.md +88 -0
  175. package/.docs/models/gateways/openrouter.md +219 -0
  176. package/.docs/models/gateways/vercel.md +225 -0
  177. package/.docs/models/gateways.md +14 -0
  178. package/.docs/models/index.md +286 -0
  179. package/.docs/models/providers/302ai.md +134 -0
  180. package/.docs/models/providers/abacus.md +125 -0
  181. package/.docs/models/providers/agentrouter.md +90 -0
  182. package/.docs/models/providers/aihubmix.md +107 -0
  183. package/.docs/models/providers/alibaba-cn.md +135 -0
  184. package/.docs/models/providers/alibaba.md +111 -0
  185. package/.docs/models/providers/amazon-bedrock.md +33 -0
  186. package/.docs/models/providers/anthropic.md +153 -0
  187. package/.docs/models/providers/azure.md +33 -0
  188. package/.docs/models/providers/bailing.md +72 -0
  189. package/.docs/models/providers/baseten.md +77 -0
  190. package/.docs/models/providers/berget.md +78 -0
  191. package/.docs/models/providers/cerebras.md +101 -0
  192. package/.docs/models/providers/chutes.md +136 -0
  193. package/.docs/models/providers/cloudflare-ai-gateway.md +33 -0
  194. package/.docs/models/providers/cloudflare-workers-ai.md +109 -0
  195. package/.docs/models/providers/cohere.md +33 -0
  196. package/.docs/models/providers/cortecs.md +91 -0
  197. package/.docs/models/providers/deepinfra.md +112 -0
  198. package/.docs/models/providers/deepseek.md +88 -0
  199. package/.docs/models/providers/fastrouter.md +84 -0
  200. package/.docs/models/providers/fireworks-ai.md +89 -0
  201. package/.docs/models/providers/firmware.md +85 -0
  202. package/.docs/models/providers/friendli.md +78 -0
  203. package/.docs/models/providers/github-models.md +125 -0
  204. package/.docs/models/providers/google-vertex.md +33 -0
  205. package/.docs/models/providers/google.md +159 -0
  206. package/.docs/models/providers/groq.md +107 -0
  207. package/.docs/models/providers/helicone.md +161 -0
  208. package/.docs/models/providers/huggingface.md +90 -0
  209. package/.docs/models/providers/iflowcn.md +84 -0
  210. package/.docs/models/providers/inception.md +72 -0
  211. package/.docs/models/providers/inference.md +79 -0
  212. package/.docs/models/providers/io-intelligence.md +87 -0
  213. package/.docs/models/providers/io-net.md +87 -0
  214. package/.docs/models/providers/jiekou.md +131 -0
  215. package/.docs/models/providers/kilo.md +333 -0
  216. package/.docs/models/providers/kimi-for-coding.md +100 -0
  217. package/.docs/models/providers/kuae-cloud-coding-plan.md +71 -0
  218. package/.docs/models/providers/llama.md +77 -0
  219. package/.docs/models/providers/lmstudio.md +73 -0
  220. package/.docs/models/providers/lucidquery.md +72 -0
  221. package/.docs/models/providers/minimax-cn-coding-plan.md +102 -0
  222. package/.docs/models/providers/minimax-cn.md +102 -0
  223. package/.docs/models/providers/minimax-coding-plan.md +102 -0
  224. package/.docs/models/providers/minimax.md +104 -0
  225. package/.docs/models/providers/mistral.md +124 -0
  226. package/.docs/models/providers/moark.md +72 -0
  227. package/.docs/models/providers/modelscope.md +77 -0
  228. package/.docs/models/providers/moonshotai-cn.md +76 -0
  229. package/.docs/models/providers/moonshotai.md +76 -0
  230. package/.docs/models/providers/morph.md +73 -0
  231. package/.docs/models/providers/nano-gpt.md +103 -0
  232. package/.docs/models/providers/nebius.md +116 -0
  233. package/.docs/models/providers/nova.md +72 -0
  234. package/.docs/models/providers/novita-ai.md +154 -0
  235. package/.docs/models/providers/nvidia.md +141 -0
  236. package/.docs/models/providers/ollama-cloud.md +103 -0
  237. package/.docs/models/providers/ollama.md +33 -0
  238. package/.docs/models/providers/openai.md +193 -0
  239. package/.docs/models/providers/opencode.md +100 -0
  240. package/.docs/models/providers/ovhcloud.md +83 -0
  241. package/.docs/models/providers/perplexity.md +100 -0
  242. package/.docs/models/providers/poe.md +183 -0
  243. package/.docs/models/providers/privatemode-ai.md +75 -0
  244. package/.docs/models/providers/requesty.md +90 -0
  245. package/.docs/models/providers/scaleway.md +84 -0
  246. package/.docs/models/providers/siliconflow-cn.md +138 -0
  247. package/.docs/models/providers/siliconflow.md +140 -0
  248. package/.docs/models/providers/stackit.md +78 -0
  249. package/.docs/models/providers/stepfun.md +73 -0
  250. package/.docs/models/providers/submodel.md +79 -0
  251. package/.docs/models/providers/synthetic.md +96 -0
  252. package/.docs/models/providers/togetherai.md +115 -0
  253. package/.docs/models/providers/upstage.md +73 -0
  254. package/.docs/models/providers/venice.md +95 -0
  255. package/.docs/models/providers/vivgrid.md +106 -0
  256. package/.docs/models/providers/vultr.md +75 -0
  257. package/.docs/models/providers/wandb.md +80 -0
  258. package/.docs/models/providers/xai.md +141 -0
  259. package/.docs/models/providers/xiaomi.md +71 -0
  260. package/.docs/models/providers/zai-coding-plan.md +80 -0
  261. package/.docs/models/providers/zai.md +79 -0
  262. package/.docs/models/providers/zenmux.md +161 -0
  263. package/.docs/models/providers/zhipuai-coding-plan.md +79 -0
  264. package/.docs/models/providers/zhipuai.md +79 -0
  265. package/.docs/models/providers.md +81 -0
  266. package/.docs/reference/agents/agent.md +141 -0
  267. package/.docs/reference/agents/generate.md +186 -0
  268. package/.docs/reference/agents/generateLegacy.md +173 -0
  269. package/.docs/reference/agents/getDefaultGenerateOptions.md +36 -0
  270. package/.docs/reference/agents/getDefaultOptions.md +34 -0
  271. package/.docs/reference/agents/getDefaultStreamOptions.md +36 -0
  272. package/.docs/reference/agents/getDescription.md +21 -0
  273. package/.docs/reference/agents/getInstructions.md +34 -0
  274. package/.docs/reference/agents/getLLM.md +37 -0
  275. package/.docs/reference/agents/getMemory.md +34 -0
  276. package/.docs/reference/agents/getModel.md +34 -0
  277. package/.docs/reference/agents/getTools.md +29 -0
  278. package/.docs/reference/agents/getVoice.md +34 -0
  279. package/.docs/reference/agents/listAgents.md +35 -0
  280. package/.docs/reference/agents/listScorers.md +34 -0
  281. package/.docs/reference/agents/listTools.md +34 -0
  282. package/.docs/reference/agents/listWorkflows.md +34 -0
  283. package/.docs/reference/agents/network.md +133 -0
  284. package/.docs/reference/ai-sdk/chat-route.md +82 -0
  285. package/.docs/reference/ai-sdk/handle-chat-stream.md +53 -0
  286. package/.docs/reference/ai-sdk/handle-network-stream.md +37 -0
  287. package/.docs/reference/ai-sdk/handle-workflow-stream.md +55 -0
  288. package/.docs/reference/ai-sdk/network-route.md +74 -0
  289. package/.docs/reference/ai-sdk/to-ai-sdk-stream.md +231 -0
  290. package/.docs/reference/ai-sdk/to-ai-sdk-v4-messages.md +79 -0
  291. package/.docs/reference/ai-sdk/to-ai-sdk-v5-messages.md +76 -0
  292. package/.docs/reference/ai-sdk/with-mastra.md +59 -0
  293. package/.docs/reference/ai-sdk/workflow-route.md +79 -0
  294. package/.docs/reference/auth/auth0.md +73 -0
  295. package/.docs/reference/auth/better-auth.md +71 -0
  296. package/.docs/reference/auth/clerk.md +36 -0
  297. package/.docs/reference/auth/firebase.md +80 -0
  298. package/.docs/reference/auth/jwt.md +26 -0
  299. package/.docs/reference/auth/supabase.md +33 -0
  300. package/.docs/reference/auth/workos.md +84 -0
  301. package/.docs/reference/cli/create-mastra.md +137 -0
  302. package/.docs/reference/cli/mastra.md +336 -0
  303. package/.docs/reference/client-js/agents.md +437 -0
  304. package/.docs/reference/client-js/error-handling.md +16 -0
  305. package/.docs/reference/client-js/logs.md +24 -0
  306. package/.docs/reference/client-js/mastra-client.md +63 -0
  307. package/.docs/reference/client-js/memory.md +221 -0
  308. package/.docs/reference/client-js/observability.md +72 -0
  309. package/.docs/reference/client-js/telemetry.md +20 -0
  310. package/.docs/reference/client-js/tools.md +44 -0
  311. package/.docs/reference/client-js/vectors.md +79 -0
  312. package/.docs/reference/client-js/workflows.md +199 -0
  313. package/.docs/reference/configuration.md +752 -0
  314. package/.docs/reference/core/addGateway.md +42 -0
  315. package/.docs/reference/core/getAgent.md +21 -0
  316. package/.docs/reference/core/getAgentById.md +21 -0
  317. package/.docs/reference/core/getDeployer.md +22 -0
  318. package/.docs/reference/core/getGateway.md +38 -0
  319. package/.docs/reference/core/getGatewayById.md +41 -0
  320. package/.docs/reference/core/getLogger.md +22 -0
  321. package/.docs/reference/core/getMCPServer.md +47 -0
  322. package/.docs/reference/core/getMCPServerById.md +55 -0
  323. package/.docs/reference/core/getMemory.md +50 -0
  324. package/.docs/reference/core/getScorer.md +54 -0
  325. package/.docs/reference/core/getScorerById.md +54 -0
  326. package/.docs/reference/core/getServer.md +22 -0
  327. package/.docs/reference/core/getStorage.md +22 -0
  328. package/.docs/reference/core/getStoredAgentById.md +89 -0
  329. package/.docs/reference/core/getTelemetry.md +22 -0
  330. package/.docs/reference/core/getVector.md +22 -0
  331. package/.docs/reference/core/getWorkflow.md +42 -0
  332. package/.docs/reference/core/listAgents.md +21 -0
  333. package/.docs/reference/core/listGateways.md +40 -0
  334. package/.docs/reference/core/listLogs.md +38 -0
  335. package/.docs/reference/core/listLogsByRunId.md +36 -0
  336. package/.docs/reference/core/listMCPServers.md +55 -0
  337. package/.docs/reference/core/listMemory.md +56 -0
  338. package/.docs/reference/core/listScorers.md +29 -0
  339. package/.docs/reference/core/listStoredAgents.md +93 -0
  340. package/.docs/reference/core/listVectors.md +22 -0
  341. package/.docs/reference/core/listWorkflows.md +21 -0
  342. package/.docs/reference/core/mastra-class.md +66 -0
  343. package/.docs/reference/core/mastra-model-gateway.md +153 -0
  344. package/.docs/reference/core/setLogger.md +26 -0
  345. package/.docs/reference/core/setStorage.md +27 -0
  346. package/.docs/reference/datasets/addItem.md +37 -0
  347. package/.docs/reference/datasets/addItems.md +35 -0
  348. package/.docs/reference/datasets/compareExperiments.md +52 -0
  349. package/.docs/reference/datasets/create.md +51 -0
  350. package/.docs/reference/datasets/dataset.md +82 -0
  351. package/.docs/reference/datasets/datasets-manager.md +94 -0
  352. package/.docs/reference/datasets/delete.md +25 -0
  353. package/.docs/reference/datasets/deleteExperiment.md +27 -0
  354. package/.docs/reference/datasets/deleteItem.md +27 -0
  355. package/.docs/reference/datasets/deleteItems.md +29 -0
  356. package/.docs/reference/datasets/get.md +31 -0
  357. package/.docs/reference/datasets/getDetails.md +47 -0
  358. package/.docs/reference/datasets/getExperiment.md +30 -0
  359. package/.docs/reference/datasets/getItem.md +33 -0
  360. package/.docs/reference/datasets/getItemHistory.md +31 -0
  361. package/.docs/reference/datasets/list.md +31 -0
  362. package/.docs/reference/datasets/listExperimentResults.md +39 -0
  363. package/.docs/reference/datasets/listExperiments.md +33 -0
  364. package/.docs/reference/datasets/listItems.md +46 -0
  365. package/.docs/reference/datasets/listVersions.md +33 -0
  366. package/.docs/reference/datasets/startExperiment.md +62 -0
  367. package/.docs/reference/datasets/startExperimentAsync.md +43 -0
  368. package/.docs/reference/datasets/update.md +48 -0
  369. package/.docs/reference/datasets/updateItem.md +38 -0
  370. package/.docs/reference/deployer/cloudflare.md +79 -0
  371. package/.docs/reference/deployer/netlify.md +80 -0
  372. package/.docs/reference/deployer/vercel.md +91 -0
  373. package/.docs/reference/deployer.md +100 -0
  374. package/.docs/reference/evals/answer-relevancy.md +105 -0
  375. package/.docs/reference/evals/answer-similarity.md +99 -0
  376. package/.docs/reference/evals/bias.md +120 -0
  377. package/.docs/reference/evals/completeness.md +136 -0
  378. package/.docs/reference/evals/content-similarity.md +101 -0
  379. package/.docs/reference/evals/context-precision.md +196 -0
  380. package/.docs/reference/evals/context-relevance.md +531 -0
  381. package/.docs/reference/evals/create-scorer.md +270 -0
  382. package/.docs/reference/evals/faithfulness.md +114 -0
  383. package/.docs/reference/evals/hallucination.md +213 -0
  384. package/.docs/reference/evals/keyword-coverage.md +128 -0
  385. package/.docs/reference/evals/mastra-scorer.md +123 -0
  386. package/.docs/reference/evals/noise-sensitivity.md +675 -0
  387. package/.docs/reference/evals/prompt-alignment.md +614 -0
  388. package/.docs/reference/evals/run-evals.md +179 -0
  389. package/.docs/reference/evals/scorer-utils.md +326 -0
  390. package/.docs/reference/evals/textual-difference.md +113 -0
  391. package/.docs/reference/evals/tone-consistency.md +119 -0
  392. package/.docs/reference/evals/tool-call-accuracy.md +533 -0
  393. package/.docs/reference/evals/toxicity.md +123 -0
  394. package/.docs/reference/harness/harness-class.md +708 -0
  395. package/.docs/reference/index.md +277 -0
  396. package/.docs/reference/logging/pino-logger.md +117 -0
  397. package/.docs/reference/mastra-code/createMastraCode.md +108 -0
  398. package/.docs/reference/memory/clone-utilities.md +199 -0
  399. package/.docs/reference/memory/cloneThread.md +130 -0
  400. package/.docs/reference/memory/createThread.md +68 -0
  401. package/.docs/reference/memory/deleteMessages.md +38 -0
  402. package/.docs/reference/memory/getThreadById.md +24 -0
  403. package/.docs/reference/memory/listThreads.md +145 -0
  404. package/.docs/reference/memory/memory-class.md +147 -0
  405. package/.docs/reference/memory/observational-memory.md +565 -0
  406. package/.docs/reference/memory/recall.md +91 -0
  407. package/.docs/reference/observability/tracing/bridges/otel.md +131 -0
  408. package/.docs/reference/observability/tracing/configuration.md +178 -0
  409. package/.docs/reference/observability/tracing/exporters/arize.md +141 -0
  410. package/.docs/reference/observability/tracing/exporters/braintrust.md +93 -0
  411. package/.docs/reference/observability/tracing/exporters/cloud-exporter.md +163 -0
  412. package/.docs/reference/observability/tracing/exporters/console-exporter.md +138 -0
  413. package/.docs/reference/observability/tracing/exporters/datadog.md +116 -0
  414. package/.docs/reference/observability/tracing/exporters/default-exporter.md +174 -0
  415. package/.docs/reference/observability/tracing/exporters/laminar.md +78 -0
  416. package/.docs/reference/observability/tracing/exporters/langfuse.md +134 -0
  417. package/.docs/reference/observability/tracing/exporters/langsmith.md +108 -0
  418. package/.docs/reference/observability/tracing/exporters/otel.md +199 -0
  419. package/.docs/reference/observability/tracing/exporters/posthog.md +92 -0
  420. package/.docs/reference/observability/tracing/exporters/sentry.md +184 -0
  421. package/.docs/reference/observability/tracing/instances.md +107 -0
  422. package/.docs/reference/observability/tracing/interfaces.md +743 -0
  423. package/.docs/reference/observability/tracing/processors/sensitive-data-filter.md +144 -0
  424. package/.docs/reference/observability/tracing/spans.md +224 -0
  425. package/.docs/reference/processors/batch-parts-processor.md +61 -0
  426. package/.docs/reference/processors/language-detector.md +82 -0
  427. package/.docs/reference/processors/message-history-processor.md +85 -0
  428. package/.docs/reference/processors/moderation-processor.md +104 -0
  429. package/.docs/reference/processors/pii-detector.md +108 -0
  430. package/.docs/reference/processors/processor-interface.md +521 -0
  431. package/.docs/reference/processors/prompt-injection-detector.md +72 -0
  432. package/.docs/reference/processors/semantic-recall-processor.md +117 -0
  433. package/.docs/reference/processors/system-prompt-scrubber.md +80 -0
  434. package/.docs/reference/processors/token-limiter-processor.md +115 -0
  435. package/.docs/reference/processors/tool-call-filter.md +85 -0
  436. package/.docs/reference/processors/tool-search-processor.md +111 -0
  437. package/.docs/reference/processors/unicode-normalizer.md +62 -0
  438. package/.docs/reference/processors/working-memory-processor.md +152 -0
  439. package/.docs/reference/rag/chunk.md +221 -0
  440. package/.docs/reference/rag/database-config.md +261 -0
  441. package/.docs/reference/rag/document.md +114 -0
  442. package/.docs/reference/rag/embeddings.md +92 -0
  443. package/.docs/reference/rag/extract-params.md +168 -0
  444. package/.docs/reference/rag/graph-rag.md +111 -0
  445. package/.docs/reference/rag/metadata-filters.md +216 -0
  446. package/.docs/reference/rag/rerank.md +75 -0
  447. package/.docs/reference/rag/rerankWithScorer.md +80 -0
  448. package/.docs/reference/server/create-route.md +262 -0
  449. package/.docs/reference/server/express-adapter.md +176 -0
  450. package/.docs/reference/server/fastify-adapter.md +90 -0
  451. package/.docs/reference/server/hono-adapter.md +162 -0
  452. package/.docs/reference/server/koa-adapter.md +127 -0
  453. package/.docs/reference/server/mastra-server.md +298 -0
  454. package/.docs/reference/server/register-api-route.md +249 -0
  455. package/.docs/reference/server/routes.md +306 -0
  456. package/.docs/reference/storage/cloudflare-d1.md +218 -0
  457. package/.docs/reference/storage/cloudflare.md +88 -0
  458. package/.docs/reference/storage/composite.md +235 -0
  459. package/.docs/reference/storage/convex.md +161 -0
  460. package/.docs/reference/storage/dynamodb.md +282 -0
  461. package/.docs/reference/storage/lance.md +131 -0
  462. package/.docs/reference/storage/libsql.md +135 -0
  463. package/.docs/reference/storage/mongodb.md +262 -0
  464. package/.docs/reference/storage/mssql.md +157 -0
  465. package/.docs/reference/storage/overview.md +121 -0
  466. package/.docs/reference/storage/postgresql.md +526 -0
  467. package/.docs/reference/storage/upstash.md +160 -0
  468. package/.docs/reference/streaming/ChunkType.md +292 -0
  469. package/.docs/reference/streaming/agents/MastraModelOutput.md +182 -0
  470. package/.docs/reference/streaming/agents/stream.md +221 -0
  471. package/.docs/reference/streaming/agents/streamLegacy.md +142 -0
  472. package/.docs/reference/streaming/workflows/observeStream.md +42 -0
  473. package/.docs/reference/streaming/workflows/resumeStream.md +61 -0
  474. package/.docs/reference/streaming/workflows/stream.md +88 -0
  475. package/.docs/reference/streaming/workflows/timeTravelStream.md +142 -0
  476. package/.docs/reference/templates/overview.md +194 -0
  477. package/.docs/reference/tools/create-tool.md +237 -0
  478. package/.docs/reference/tools/document-chunker-tool.md +89 -0
  479. package/.docs/reference/tools/graph-rag-tool.md +182 -0
  480. package/.docs/reference/tools/mcp-client.md +954 -0
  481. package/.docs/reference/tools/mcp-server.md +1271 -0
  482. package/.docs/reference/tools/vector-query-tool.md +459 -0
  483. package/.docs/reference/vectors/astra.md +121 -0
  484. package/.docs/reference/vectors/chroma.md +264 -0
  485. package/.docs/reference/vectors/convex.md +300 -0
  486. package/.docs/reference/vectors/couchbase.md +226 -0
  487. package/.docs/reference/vectors/duckdb.md +318 -0
  488. package/.docs/reference/vectors/elasticsearch.md +189 -0
  489. package/.docs/reference/vectors/lance.md +220 -0
  490. package/.docs/reference/vectors/libsql.md +305 -0
  491. package/.docs/reference/vectors/mongodb.md +295 -0
  492. package/.docs/reference/vectors/opensearch.md +99 -0
  493. package/.docs/reference/vectors/pg.md +408 -0
  494. package/.docs/reference/vectors/pinecone.md +168 -0
  495. package/.docs/reference/vectors/qdrant.md +222 -0
  496. package/.docs/reference/vectors/s3vectors.md +277 -0
  497. package/.docs/reference/vectors/turbopuffer.md +157 -0
  498. package/.docs/reference/vectors/upstash.md +294 -0
  499. package/.docs/reference/vectors/vectorize.md +147 -0
  500. package/.docs/reference/voice/azure.md +148 -0
  501. package/.docs/reference/voice/cloudflare.md +83 -0
  502. package/.docs/reference/voice/composite-voice.md +121 -0
  503. package/.docs/reference/voice/deepgram.md +79 -0
  504. package/.docs/reference/voice/elevenlabs.md +98 -0
  505. package/.docs/reference/voice/google-gemini-live.md +378 -0
  506. package/.docs/reference/voice/google.md +228 -0
  507. package/.docs/reference/voice/mastra-voice.md +311 -0
  508. package/.docs/reference/voice/murf.md +122 -0
  509. package/.docs/reference/voice/openai-realtime.md +203 -0
  510. package/.docs/reference/voice/openai.md +88 -0
  511. package/.docs/reference/voice/playai.md +80 -0
  512. package/.docs/reference/voice/sarvam.md +126 -0
  513. package/.docs/reference/voice/speechify.md +75 -0
  514. package/.docs/reference/voice/voice.addInstructions.md +55 -0
  515. package/.docs/reference/voice/voice.addTools.md +67 -0
  516. package/.docs/reference/voice/voice.answer.md +54 -0
  517. package/.docs/reference/voice/voice.close.md +51 -0
  518. package/.docs/reference/voice/voice.connect.md +94 -0
  519. package/.docs/reference/voice/voice.events.md +37 -0
  520. package/.docs/reference/voice/voice.getSpeakers.md +129 -0
  521. package/.docs/reference/voice/voice.listen.md +164 -0
  522. package/.docs/reference/voice/voice.off.md +54 -0
  523. package/.docs/reference/voice/voice.on.md +111 -0
  524. package/.docs/reference/voice/voice.send.md +65 -0
  525. package/.docs/reference/voice/voice.speak.md +157 -0
  526. package/.docs/reference/voice/voice.updateConfig.md +60 -0
  527. package/.docs/reference/workflows/run-methods/cancel.md +86 -0
  528. package/.docs/reference/workflows/run-methods/restart.md +33 -0
  529. package/.docs/reference/workflows/run-methods/resume.md +59 -0
  530. package/.docs/reference/workflows/run-methods/start.md +58 -0
  531. package/.docs/reference/workflows/run-methods/startAsync.md +67 -0
  532. package/.docs/reference/workflows/run-methods/timeTravel.md +142 -0
  533. package/.docs/reference/workflows/run.md +59 -0
  534. package/.docs/reference/workflows/step.md +119 -0
  535. package/.docs/reference/workflows/workflow-methods/branch.md +25 -0
  536. package/.docs/reference/workflows/workflow-methods/commit.md +17 -0
  537. package/.docs/reference/workflows/workflow-methods/create-run.md +63 -0
  538. package/.docs/reference/workflows/workflow-methods/dountil.md +25 -0
  539. package/.docs/reference/workflows/workflow-methods/dowhile.md +25 -0
  540. package/.docs/reference/workflows/workflow-methods/foreach.md +118 -0
  541. package/.docs/reference/workflows/workflow-methods/map.md +93 -0
  542. package/.docs/reference/workflows/workflow-methods/parallel.md +21 -0
  543. package/.docs/reference/workflows/workflow-methods/sleep.md +35 -0
  544. package/.docs/reference/workflows/workflow-methods/sleepUntil.md +35 -0
  545. package/.docs/reference/workflows/workflow-methods/then.md +21 -0
  546. package/.docs/reference/workflows/workflow.md +157 -0
  547. package/.docs/reference/workspace/e2b-sandbox.md +289 -0
  548. package/.docs/reference/workspace/filesystem.md +255 -0
  549. package/.docs/reference/workspace/gcs-filesystem.md +174 -0
  550. package/.docs/reference/workspace/local-filesystem.md +343 -0
  551. package/.docs/reference/workspace/local-sandbox.md +301 -0
  552. package/.docs/reference/workspace/s3-filesystem.md +175 -0
  553. package/.docs/reference/workspace/sandbox.md +87 -0
  554. package/.docs/reference/workspace/workspace-class.md +244 -0
  555. package/CHANGELOG.md +8 -0
  556. package/package.json +5 -5
@@ -0,0 +1,84 @@
1
+ # ![Scaleway logo](https://models.dev/logos/scaleway.svg)Scaleway
2
+
3
+ Access 14 Scaleway models through Mastra's model router. Authentication is handled automatically using the `SCALEWAY_API_KEY` environment variable.
4
+
5
+ Learn more in the [Scaleway documentation](https://www.scaleway.com/en/docs/generative-apis/).
6
+
7
+ ```bash
8
+ SCALEWAY_API_KEY=your-api-key
9
+ ```
10
+
11
+ ```typescript
12
+ import { Agent } from "@mastra/core/agent";
13
+
14
+ const agent = new Agent({
15
+ id: "my-agent",
16
+ name: "My Agent",
17
+ instructions: "You are a helpful assistant",
18
+ model: "scaleway/bge-multilingual-gemma2"
19
+ });
20
+
21
+ // Generate a response
22
+ const response = await agent.generate("Hello!");
23
+
24
+ // Stream a response
25
+ const stream = await agent.stream("Tell me a story");
26
+ for await (const chunk of stream) {
27
+ console.log(chunk);
28
+ }
29
+ ```
30
+
31
+ > **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Scaleway documentation](https://www.scaleway.com/en/docs/generative-apis/) for details.
32
+
33
+ ## Models
34
+
35
+ | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
36
+ | ---------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
+ | `scaleway/bge-multilingual-gemma2` | 8K | | | | | | $0.13 | — |
38
+ | `scaleway/deepseek-r1-distill-llama-70b` | 32K | | | | | | $0.90 | $0.90 |
39
+ | `scaleway/devstral-2-123b-instruct-2512` | 256K | | | | | | $0.40 | $2 |
40
+ | `scaleway/gemma-3-27b-it` | 40K | | | | | | $0.25 | $0.50 |
41
+ | `scaleway/gpt-oss-120b` | 128K | | | | | | $0.15 | $0.60 |
42
+ | `scaleway/llama-3.1-8b-instruct` | 128K | | | | | | $0.20 | $0.20 |
43
+ | `scaleway/llama-3.3-70b-instruct` | 100K | | | | | | $0.90 | $0.90 |
44
+ | `scaleway/mistral-nemo-instruct-2407` | 128K | | | | | | $0.20 | $0.20 |
45
+ | `scaleway/mistral-small-3.2-24b-instruct-2506` | 128K | | | | | | $0.15 | $0.35 |
46
+ | `scaleway/pixtral-12b-2409` | 128K | | | | | | $0.20 | $0.20 |
47
+ | `scaleway/qwen3-235b-a22b-instruct-2507` | 260K | | | | | | $0.75 | $2 |
48
+ | `scaleway/qwen3-coder-30b-a3b-instruct` | 128K | | | | | | $0.20 | $0.80 |
49
+ | `scaleway/voxtral-small-24b-2507` | 32K | | | | | | $0.15 | $0.35 |
50
+ | `scaleway/whisper-large-v3` | — | | | | | | $0.00 | — |
51
+
52
+ ## Advanced Configuration
53
+
54
+ ### Custom Headers
55
+
56
+ ```typescript
57
+ const agent = new Agent({
58
+ id: "custom-agent",
59
+ name: "custom-agent",
60
+ model: {
61
+ url: "https://api.scaleway.ai/v1",
62
+ id: "scaleway/bge-multilingual-gemma2",
63
+ apiKey: process.env.SCALEWAY_API_KEY,
64
+ headers: {
65
+ "X-Custom-Header": "value"
66
+ }
67
+ }
68
+ });
69
+ ```
70
+
71
+ ### Dynamic Model Selection
72
+
73
+ ```typescript
74
+ const agent = new Agent({
75
+ id: "dynamic-agent",
76
+ name: "Dynamic Agent",
77
+ model: ({ requestContext }) => {
78
+ const useAdvanced = requestContext.task === "complex";
79
+ return useAdvanced
80
+ ? "scaleway/whisper-large-v3"
81
+ : "scaleway/bge-multilingual-gemma2";
82
+ }
83
+ });
84
+ ```
@@ -0,0 +1,138 @@
1
+ # ![SiliconFlow (China) logo](https://models.dev/logos/siliconflow-cn.svg)SiliconFlow (China)
2
+
3
+ Access 68 SiliconFlow (China) models through Mastra's model router. Authentication is handled automatically using the `SILICONFLOW_CN_API_KEY` environment variable.
4
+
5
+ Learn more in the [SiliconFlow (China) documentation](https://cloud.siliconflow.com/models).
6
+
7
+ ```bash
8
+ SILICONFLOW_CN_API_KEY=your-api-key
9
+ ```
10
+
11
+ ```typescript
12
+ import { Agent } from "@mastra/core/agent";
13
+
14
+ const agent = new Agent({
15
+ id: "my-agent",
16
+ name: "My Agent",
17
+ instructions: "You are a helpful assistant",
18
+ model: "siliconflow-cn/ByteDance-Seed/Seed-OSS-36B-Instruct"
19
+ });
20
+
21
+ // Generate a response
22
+ const response = await agent.generate("Hello!");
23
+
24
+ // Stream a response
25
+ const stream = await agent.stream("Tell me a story");
26
+ for await (const chunk of stream) {
27
+ console.log(chunk);
28
+ }
29
+ ```
30
+
31
+ > **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [SiliconFlow (China) documentation](https://cloud.siliconflow.com/models) for details.
32
+
33
+ ## Models
34
+
35
+ | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
36
+ | --------------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
+ | `siliconflow-cn/ascend-tribe/pangu-pro-moe` | 128K | | | | | | $0.20 | $0.60 |
38
+ | `siliconflow-cn/baidu/ERNIE-4.5-300B-A47B` | 131K | | | | | | $0.28 | $1 |
39
+ | `siliconflow-cn/ByteDance-Seed/Seed-OSS-36B-Instruct` | 262K | | | | | | $0.21 | $0.57 |
40
+ | `siliconflow-cn/deepseek-ai/DeepSeek-R1` | 164K | | | | | | $0.50 | $2 |
41
+ | `siliconflow-cn/deepseek-ai/DeepSeek-R1-Distill-Qwen-14B` | 131K | | | | | | $0.10 | $0.10 |
42
+ | `siliconflow-cn/deepseek-ai/DeepSeek-R1-Distill-Qwen-32B` | 131K | | | | | | $0.18 | $0.18 |
43
+ | `siliconflow-cn/deepseek-ai/DeepSeek-V3` | 164K | | | | | | $0.25 | $1 |
44
+ | `siliconflow-cn/deepseek-ai/DeepSeek-V3.1-Terminus` | 164K | | | | | | $0.27 | $1 |
45
+ | `siliconflow-cn/deepseek-ai/DeepSeek-V3.2` | 164K | | | | | | $0.27 | $0.42 |
46
+ | `siliconflow-cn/deepseek-ai/deepseek-vl2` | 4K | | | | | | $0.15 | $0.15 |
47
+ | `siliconflow-cn/inclusionAI/Ling-flash-2.0` | 131K | | | | | | $0.14 | $0.57 |
48
+ | `siliconflow-cn/inclusionAI/Ling-mini-2.0` | 131K | | | | | | $0.07 | $0.28 |
49
+ | `siliconflow-cn/inclusionAI/Ring-flash-2.0` | 131K | | | | | | $0.14 | $0.57 |
50
+ | `siliconflow-cn/Kwaipilot/KAT-Dev` | 128K | | | | | | $0.20 | $0.60 |
51
+ | `siliconflow-cn/moonshotai/Kimi-K2-Instruct-0905` | 262K | | | | | | $0.40 | $2 |
52
+ | `siliconflow-cn/moonshotai/Kimi-K2-Thinking` | 262K | | | | | | $0.55 | $3 |
53
+ | `siliconflow-cn/Pro/deepseek-ai/DeepSeek-R1` | 164K | | | | | | $0.50 | $2 |
54
+ | `siliconflow-cn/Pro/deepseek-ai/DeepSeek-V3` | 164K | | | | | | $0.25 | $1 |
55
+ | `siliconflow-cn/Pro/deepseek-ai/DeepSeek-V3.1-Terminus` | 164K | | | | | | $0.27 | $1 |
56
+ | `siliconflow-cn/Pro/deepseek-ai/DeepSeek-V3.2` | 164K | | | | | | $0.27 | $0.42 |
57
+ | `siliconflow-cn/Pro/MiniMaxAI/MiniMax-M2.1` | 197K | | | | | | $0.30 | $1 |
58
+ | `siliconflow-cn/Pro/moonshotai/Kimi-K2-Instruct-0905` | 262K | | | | | | $0.40 | $2 |
59
+ | `siliconflow-cn/Pro/moonshotai/Kimi-K2-Thinking` | 262K | | | | | | $0.55 | $3 |
60
+ | `siliconflow-cn/Pro/moonshotai/Kimi-K2.5` | 262K | | | | | | $0.55 | $3 |
61
+ | `siliconflow-cn/Pro/zai-org/GLM-4.7` | 205K | | | | | | $0.60 | $2 |
62
+ | `siliconflow-cn/Pro/zai-org/GLM-5` | 205K | | | | | | $1 | $3 |
63
+ | `siliconflow-cn/Qwen/Qwen2.5-14B-Instruct` | 33K | | | | | | $0.10 | $0.10 |
64
+ | `siliconflow-cn/Qwen/Qwen2.5-32B-Instruct` | 33K | | | | | | $0.18 | $0.18 |
65
+ | `siliconflow-cn/Qwen/Qwen2.5-72B-Instruct` | 33K | | | | | | $0.59 | $0.59 |
66
+ | `siliconflow-cn/Qwen/Qwen2.5-72B-Instruct-128K` | 131K | | | | | | $0.59 | $0.59 |
67
+ | `siliconflow-cn/Qwen/Qwen2.5-7B-Instruct` | 33K | | | | | | $0.05 | $0.05 |
68
+ | `siliconflow-cn/Qwen/Qwen2.5-Coder-32B-Instruct` | 33K | | | | | | $0.18 | $0.18 |
69
+ | `siliconflow-cn/Qwen/Qwen2.5-VL-32B-Instruct` | 131K | | | | | | $0.27 | $0.27 |
70
+ | `siliconflow-cn/Qwen/Qwen2.5-VL-72B-Instruct` | 131K | | | | | | $0.59 | $0.59 |
71
+ | `siliconflow-cn/Qwen/Qwen3-14B` | 131K | | | | | | $0.07 | $0.28 |
72
+ | `siliconflow-cn/Qwen/Qwen3-235B-A22B-Instruct-2507` | 262K | | | | | | $0.09 | $0.60 |
73
+ | `siliconflow-cn/Qwen/Qwen3-235B-A22B-Thinking-2507` | 262K | | | | | | $0.13 | $0.60 |
74
+ | `siliconflow-cn/Qwen/Qwen3-30B-A3B-Instruct-2507` | 262K | | | | | | $0.09 | $0.30 |
75
+ | `siliconflow-cn/Qwen/Qwen3-30B-A3B-Thinking-2507` | 262K | | | | | | $0.09 | $0.30 |
76
+ | `siliconflow-cn/Qwen/Qwen3-32B` | 131K | | | | | | $0.14 | $0.57 |
77
+ | `siliconflow-cn/Qwen/Qwen3-8B` | 131K | | | | | | $0.06 | $0.06 |
78
+ | `siliconflow-cn/Qwen/Qwen3-Coder-30B-A3B-Instruct` | 262K | | | | | | $0.07 | $0.28 |
79
+ | `siliconflow-cn/Qwen/Qwen3-Coder-480B-A35B-Instruct` | 262K | | | | | | $0.25 | $1 |
80
+ | `siliconflow-cn/Qwen/Qwen3-Next-80B-A3B-Instruct` | 262K | | | | | | $0.14 | $1 |
81
+ | `siliconflow-cn/Qwen/Qwen3-Next-80B-A3B-Thinking` | 262K | | | | | | $0.14 | $0.57 |
82
+ | `siliconflow-cn/Qwen/Qwen3-Omni-30B-A3B-Captioner` | 66K | | | | | | $0.10 | $0.40 |
83
+ | `siliconflow-cn/Qwen/Qwen3-Omni-30B-A3B-Instruct` | 66K | | | | | | $0.10 | $0.40 |
84
+ | `siliconflow-cn/Qwen/Qwen3-Omni-30B-A3B-Thinking` | 66K | | | | | | $0.10 | $0.40 |
85
+ | `siliconflow-cn/Qwen/Qwen3-VL-235B-A22B-Instruct` | 262K | | | | | | $0.30 | $2 |
86
+ | `siliconflow-cn/Qwen/Qwen3-VL-235B-A22B-Thinking` | 262K | | | | | | $0.45 | $4 |
87
+ | `siliconflow-cn/Qwen/Qwen3-VL-30B-A3B-Instruct` | 262K | | | | | | $0.29 | $1 |
88
+ | `siliconflow-cn/Qwen/Qwen3-VL-30B-A3B-Thinking` | 262K | | | | | | $0.29 | $1 |
89
+ | `siliconflow-cn/Qwen/Qwen3-VL-32B-Instruct` | 262K | | | | | | $0.20 | $0.60 |
90
+ | `siliconflow-cn/Qwen/Qwen3-VL-32B-Thinking` | 262K | | | | | | $0.20 | $2 |
91
+ | `siliconflow-cn/Qwen/Qwen3-VL-8B-Instruct` | 262K | | | | | | $0.18 | $0.68 |
92
+ | `siliconflow-cn/Qwen/Qwen3-VL-8B-Thinking` | 262K | | | | | | $0.18 | $2 |
93
+ | `siliconflow-cn/Qwen/QwQ-32B` | 131K | | | | | | $0.15 | $0.58 |
94
+ | `siliconflow-cn/stepfun-ai/Step-3.5-Flash` | 262K | | | | | | $0.10 | $0.30 |
95
+ | `siliconflow-cn/tencent/Hunyuan-A13B-Instruct` | 131K | | | | | | $0.14 | $0.57 |
96
+ | `siliconflow-cn/tencent/Hunyuan-MT-7B` | 33K | | | | | | — | — |
97
+ | `siliconflow-cn/THUDM/GLM-4-32B-0414` | 33K | | | | | | $0.27 | $0.27 |
98
+ | `siliconflow-cn/THUDM/GLM-4-9B-0414` | 33K | | | | | | $0.09 | $0.09 |
99
+ | `siliconflow-cn/THUDM/GLM-Z1-32B-0414` | 131K | | | | | | $0.14 | $0.57 |
100
+ | `siliconflow-cn/THUDM/GLM-Z1-9B-0414` | 131K | | | | | | $0.09 | $0.09 |
101
+ | `siliconflow-cn/zai-org/GLM-4.5-Air` | 131K | | | | | | $0.14 | $0.86 |
102
+ | `siliconflow-cn/zai-org/GLM-4.5V` | 66K | | | | | | $0.14 | $0.86 |
103
+ | `siliconflow-cn/zai-org/GLM-4.6` | 205K | | | | | | $0.50 | $2 |
104
+ | `siliconflow-cn/zai-org/GLM-4.6V` | 131K | | | | | | $0.30 | $0.90 |
105
+
106
+ ## Advanced Configuration
107
+
108
+ ### Custom Headers
109
+
110
+ ```typescript
111
+ const agent = new Agent({
112
+ id: "custom-agent",
113
+ name: "custom-agent",
114
+ model: {
115
+ url: "https://api.siliconflow.cn/v1",
116
+ id: "siliconflow-cn/ByteDance-Seed/Seed-OSS-36B-Instruct",
117
+ apiKey: process.env.SILICONFLOW_CN_API_KEY,
118
+ headers: {
119
+ "X-Custom-Header": "value"
120
+ }
121
+ }
122
+ });
123
+ ```
124
+
125
+ ### Dynamic Model Selection
126
+
127
+ ```typescript
128
+ const agent = new Agent({
129
+ id: "dynamic-agent",
130
+ name: "Dynamic Agent",
131
+ model: ({ requestContext }) => {
132
+ const useAdvanced = requestContext.task === "complex";
133
+ return useAdvanced
134
+ ? "siliconflow-cn/zai-org/GLM-4.6V"
135
+ : "siliconflow-cn/ByteDance-Seed/Seed-OSS-36B-Instruct";
136
+ }
137
+ });
138
+ ```
@@ -0,0 +1,140 @@
1
+ # ![SiliconFlow logo](https://models.dev/logos/siliconflow.svg)SiliconFlow
2
+
3
+ Access 70 SiliconFlow models through Mastra's model router. Authentication is handled automatically using the `SILICONFLOW_API_KEY` environment variable.
4
+
5
+ Learn more in the [SiliconFlow documentation](https://cloud.siliconflow.com/models).
6
+
7
+ ```bash
8
+ SILICONFLOW_API_KEY=your-api-key
9
+ ```
10
+
11
+ ```typescript
12
+ import { Agent } from "@mastra/core/agent";
13
+
14
+ const agent = new Agent({
15
+ id: "my-agent",
16
+ name: "My Agent",
17
+ instructions: "You are a helpful assistant",
18
+ model: "siliconflow/ByteDance-Seed/Seed-OSS-36B-Instruct"
19
+ });
20
+
21
+ // Generate a response
22
+ const response = await agent.generate("Hello!");
23
+
24
+ // Stream a response
25
+ const stream = await agent.stream("Tell me a story");
26
+ for await (const chunk of stream) {
27
+ console.log(chunk);
28
+ }
29
+ ```
30
+
31
+ > **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [SiliconFlow documentation](https://cloud.siliconflow.com/models) for details.
32
+
33
+ ## Models
34
+
35
+ | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
36
+ | ------------------------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
+ | `siliconflow/baidu/ERNIE-4.5-300B-A47B` | 131K | | | | | | $0.28 | $1 |
38
+ | `siliconflow/ByteDance-Seed/Seed-OSS-36B-Instruct` | 262K | | | | | | $0.21 | $0.57 |
39
+ | `siliconflow/deepseek-ai/DeepSeek-R1` | 164K | | | | | | $0.50 | $2 |
40
+ | `siliconflow/deepseek-ai/DeepSeek-R1-Distill-Qwen-14B` | 131K | | | | | | $0.10 | $0.10 |
41
+ | `siliconflow/deepseek-ai/DeepSeek-R1-Distill-Qwen-32B` | 131K | | | | | | $0.18 | $0.18 |
42
+ | `siliconflow/deepseek-ai/DeepSeek-V3` | 164K | | | | | | $0.25 | $1 |
43
+ | `siliconflow/deepseek-ai/DeepSeek-V3.1` | 164K | | | | | | $0.27 | $1 |
44
+ | `siliconflow/deepseek-ai/DeepSeek-V3.1-Terminus` | 164K | | | | | | $0.27 | $1 |
45
+ | `siliconflow/deepseek-ai/DeepSeek-V3.2` | 164K | | | | | | $0.27 | $0.42 |
46
+ | `siliconflow/deepseek-ai/DeepSeek-V3.2-Exp` | 164K | | | | | | $0.27 | $0.41 |
47
+ | `siliconflow/deepseek-ai/deepseek-vl2` | 4K | | | | | | $0.15 | $0.15 |
48
+ | `siliconflow/inclusionAI/Ling-flash-2.0` | 131K | | | | | | $0.14 | $0.57 |
49
+ | `siliconflow/inclusionAI/Ling-mini-2.0` | 131K | | | | | | $0.07 | $0.28 |
50
+ | `siliconflow/inclusionAI/Ring-flash-2.0` | 131K | | | | | | $0.14 | $0.57 |
51
+ | `siliconflow/meta-llama/Meta-Llama-3.1-8B-Instruct` | 33K | | | | | | $0.06 | $0.06 |
52
+ | `siliconflow/MiniMaxAI/MiniMax-M2.1` | 197K | | | | | | $0.30 | $1 |
53
+ | `siliconflow/moonshotai/Kimi-K2-Instruct` | 131K | | | | | | $0.58 | $2 |
54
+ | `siliconflow/moonshotai/Kimi-K2-Instruct-0905` | 262K | | | | | | $0.40 | $2 |
55
+ | `siliconflow/moonshotai/Kimi-K2-Thinking` | 262K | | | | | | $0.55 | $3 |
56
+ | `siliconflow/moonshotai/Kimi-K2.5` | 262K | | | | | | $0.55 | $3 |
57
+ | `siliconflow/nex-agi/DeepSeek-V3.1-Nex-N1` | 131K | | | | | | $0.50 | $2 |
58
+ | `siliconflow/openai/gpt-oss-120b` | 131K | | | | | | $0.05 | $0.45 |
59
+ | `siliconflow/openai/gpt-oss-20b` | 131K | | | | | | $0.04 | $0.18 |
60
+ | `siliconflow/Qwen/Qwen2.5-14B-Instruct` | 33K | | | | | | $0.10 | $0.10 |
61
+ | `siliconflow/Qwen/Qwen2.5-32B-Instruct` | 33K | | | | | | $0.18 | $0.18 |
62
+ | `siliconflow/Qwen/Qwen2.5-72B-Instruct` | 33K | | | | | | $0.59 | $0.59 |
63
+ | `siliconflow/Qwen/Qwen2.5-72B-Instruct-128K` | 131K | | | | | | $0.59 | $0.59 |
64
+ | `siliconflow/Qwen/Qwen2.5-7B-Instruct` | 33K | | | | | | $0.05 | $0.05 |
65
+ | `siliconflow/Qwen/Qwen2.5-Coder-32B-Instruct` | 33K | | | | | | $0.18 | $0.18 |
66
+ | `siliconflow/Qwen/Qwen2.5-VL-32B-Instruct` | 131K | | | | | | $0.27 | $0.27 |
67
+ | `siliconflow/Qwen/Qwen2.5-VL-72B-Instruct` | 131K | | | | | | $0.59 | $0.59 |
68
+ | `siliconflow/Qwen/Qwen2.5-VL-7B-Instruct` | 33K | | | | | | $0.05 | $0.05 |
69
+ | `siliconflow/Qwen/Qwen3-14B` | 131K | | | | | | $0.07 | $0.28 |
70
+ | `siliconflow/Qwen/Qwen3-235B-A22B` | 131K | | | | | | $0.35 | $1 |
71
+ | `siliconflow/Qwen/Qwen3-235B-A22B-Instruct-2507` | 262K | | | | | | $0.09 | $0.60 |
72
+ | `siliconflow/Qwen/Qwen3-235B-A22B-Thinking-2507` | 262K | | | | | | $0.13 | $0.60 |
73
+ | `siliconflow/Qwen/Qwen3-30B-A3B-Instruct-2507` | 262K | | | | | | $0.09 | $0.30 |
74
+ | `siliconflow/Qwen/Qwen3-30B-A3B-Thinking-2507` | 262K | | | | | | $0.09 | $0.30 |
75
+ | `siliconflow/Qwen/Qwen3-32B` | 131K | | | | | | $0.14 | $0.57 |
76
+ | `siliconflow/Qwen/Qwen3-8B` | 131K | | | | | | $0.06 | $0.06 |
77
+ | `siliconflow/Qwen/Qwen3-Coder-30B-A3B-Instruct` | 262K | | | | | | $0.07 | $0.28 |
78
+ | `siliconflow/Qwen/Qwen3-Coder-480B-A35B-Instruct` | 262K | | | | | | $0.25 | $1 |
79
+ | `siliconflow/Qwen/Qwen3-Next-80B-A3B-Instruct` | 262K | | | | | | $0.14 | $1 |
80
+ | `siliconflow/Qwen/Qwen3-Next-80B-A3B-Thinking` | 262K | | | | | | $0.14 | $0.57 |
81
+ | `siliconflow/Qwen/Qwen3-Omni-30B-A3B-Captioner` | 66K | | | | | | $0.10 | $0.40 |
82
+ | `siliconflow/Qwen/Qwen3-Omni-30B-A3B-Instruct` | 66K | | | | | | $0.10 | $0.40 |
83
+ | `siliconflow/Qwen/Qwen3-Omni-30B-A3B-Thinking` | 66K | | | | | | $0.10 | $0.40 |
84
+ | `siliconflow/Qwen/Qwen3-VL-235B-A22B-Instruct` | 262K | | | | | | $0.30 | $2 |
85
+ | `siliconflow/Qwen/Qwen3-VL-235B-A22B-Thinking` | 262K | | | | | | $0.45 | $4 |
86
+ | `siliconflow/Qwen/Qwen3-VL-30B-A3B-Instruct` | 262K | | | | | | $0.29 | $1 |
87
+ | `siliconflow/Qwen/Qwen3-VL-30B-A3B-Thinking` | 262K | | | | | | $0.29 | $1 |
88
+ | `siliconflow/Qwen/Qwen3-VL-32B-Instruct` | 262K | | | | | | $0.20 | $0.60 |
89
+ | `siliconflow/Qwen/Qwen3-VL-32B-Thinking` | 262K | | | | | | $0.20 | $2 |
90
+ | `siliconflow/Qwen/Qwen3-VL-8B-Instruct` | 262K | | | | | | $0.18 | $0.68 |
91
+ | `siliconflow/Qwen/Qwen3-VL-8B-Thinking` | 262K | | | | | | $0.18 | $2 |
92
+ | `siliconflow/Qwen/QwQ-32B` | 131K | | | | | | $0.15 | $0.58 |
93
+ | `siliconflow/stepfun-ai/Step-3.5-Flash` | 262K | | | | | | $0.10 | $0.30 |
94
+ | `siliconflow/tencent/Hunyuan-A13B-Instruct` | 131K | | | | | | $0.14 | $0.57 |
95
+ | `siliconflow/tencent/Hunyuan-MT-7B` | 33K | | | | | | — | — |
96
+ | `siliconflow/THUDM/GLM-4-32B-0414` | 33K | | | | | | $0.27 | $0.27 |
97
+ | `siliconflow/THUDM/GLM-4-9B-0414` | 33K | | | | | | $0.09 | $0.09 |
98
+ | `siliconflow/THUDM/GLM-Z1-32B-0414` | 131K | | | | | | $0.14 | $0.57 |
99
+ | `siliconflow/THUDM/GLM-Z1-9B-0414` | 131K | | | | | | $0.09 | $0.09 |
100
+ | `siliconflow/zai-org/GLM-4.5` | 131K | | | | | | $0.40 | $2 |
101
+ | `siliconflow/zai-org/GLM-4.5-Air` | 131K | | | | | | $0.14 | $0.86 |
102
+ | `siliconflow/zai-org/GLM-4.5V` | 66K | | | | | | $0.14 | $0.86 |
103
+ | `siliconflow/zai-org/GLM-4.6` | 205K | | | | | | $0.50 | $2 |
104
+ | `siliconflow/zai-org/GLM-4.6V` | 131K | | | | | | $0.30 | $0.90 |
105
+ | `siliconflow/zai-org/GLM-4.7` | 205K | | | | | | $0.60 | $2 |
106
+ | `siliconflow/zai-org/GLM-5` | 205K | | | | | | $1 | $3 |
107
+
108
+ ## Advanced Configuration
109
+
110
+ ### Custom Headers
111
+
112
+ ```typescript
113
+ const agent = new Agent({
114
+ id: "custom-agent",
115
+ name: "custom-agent",
116
+ model: {
117
+ url: "https://api.siliconflow.com/v1",
118
+ id: "siliconflow/ByteDance-Seed/Seed-OSS-36B-Instruct",
119
+ apiKey: process.env.SILICONFLOW_API_KEY,
120
+ headers: {
121
+ "X-Custom-Header": "value"
122
+ }
123
+ }
124
+ });
125
+ ```
126
+
127
+ ### Dynamic Model Selection
128
+
129
+ ```typescript
130
+ const agent = new Agent({
131
+ id: "dynamic-agent",
132
+ name: "Dynamic Agent",
133
+ model: ({ requestContext }) => {
134
+ const useAdvanced = requestContext.task === "complex";
135
+ return useAdvanced
136
+ ? "siliconflow/zai-org/GLM-5"
137
+ : "siliconflow/ByteDance-Seed/Seed-OSS-36B-Instruct";
138
+ }
139
+ });
140
+ ```
@@ -0,0 +1,78 @@
1
+ # ![STACKIT logo](https://models.dev/logos/stackit.svg)STACKIT
2
+
3
+ Access 8 STACKIT models through Mastra's model router. Authentication is handled automatically using the `STACKIT_API_KEY` environment variable.
4
+
5
+ Learn more in the [STACKIT documentation](https://docs.stackit.cloud/products/data-and-ai/ai-model-serving/basics/available-shared-models).
6
+
7
+ ```bash
8
+ STACKIT_API_KEY=your-api-key
9
+ ```
10
+
11
+ ```typescript
12
+ import { Agent } from "@mastra/core/agent";
13
+
14
+ const agent = new Agent({
15
+ id: "my-agent",
16
+ name: "My Agent",
17
+ instructions: "You are a helpful assistant",
18
+ model: "stackit/Qwen/Qwen3-VL-235B-A22B-Instruct-FP8"
19
+ });
20
+
21
+ // Generate a response
22
+ const response = await agent.generate("Hello!");
23
+
24
+ // Stream a response
25
+ const stream = await agent.stream("Tell me a story");
26
+ for await (const chunk of stream) {
27
+ console.log(chunk);
28
+ }
29
+ ```
30
+
31
+ > **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [STACKIT documentation](https://docs.stackit.cloud/products/data-and-ai/ai-model-serving/basics/available-shared-models) for details.
32
+
33
+ ## Models
34
+
35
+ | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
36
+ | ---------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
+ | `stackit/cortecs/Llama-3.3-70B-Instruct-FP8-Dynamic` | 128K | | | | | | $0.49 | $0.71 |
38
+ | `stackit/google/gemma-3-27b-it` | 37K | | | | | | $0.49 | $0.71 |
39
+ | `stackit/intfloat/e5-mistral-7b-instruct` | 4K | | | | | | $0.02 | $0.02 |
40
+ | `stackit/neuralmagic/Meta-Llama-3.1-8B-Instruct-FP8` | 128K | | | | | | $0.16 | $0.27 |
41
+ | `stackit/neuralmagic/Mistral-Nemo-Instruct-2407-FP8` | 128K | | | | | | $0.49 | $0.71 |
42
+ | `stackit/openai/gpt-oss-120b` | 131K | | | | | | $0.49 | $0.71 |
43
+ | `stackit/Qwen/Qwen3-VL-235B-A22B-Instruct-FP8` | 218K | | | | | | $2 | $2 |
44
+ | `stackit/Qwen/Qwen3-VL-Embedding-8B` | 32K | | | | | | $0.09 | $0.09 |
45
+
46
+ ## Advanced Configuration
47
+
48
+ ### Custom Headers
49
+
50
+ ```typescript
51
+ const agent = new Agent({
52
+ id: "custom-agent",
53
+ name: "custom-agent",
54
+ model: {
55
+ url: "https://api.openai-compat.model-serving.eu01.onstackit.cloud/v1",
56
+ id: "stackit/Qwen/Qwen3-VL-235B-A22B-Instruct-FP8",
57
+ apiKey: process.env.STACKIT_API_KEY,
58
+ headers: {
59
+ "X-Custom-Header": "value"
60
+ }
61
+ }
62
+ });
63
+ ```
64
+
65
+ ### Dynamic Model Selection
66
+
67
+ ```typescript
68
+ const agent = new Agent({
69
+ id: "dynamic-agent",
70
+ name: "Dynamic Agent",
71
+ model: ({ requestContext }) => {
72
+ const useAdvanced = requestContext.task === "complex";
73
+ return useAdvanced
74
+ ? "stackit/openai/gpt-oss-120b"
75
+ : "stackit/Qwen/Qwen3-VL-235B-A22B-Instruct-FP8";
76
+ }
77
+ });
78
+ ```
@@ -0,0 +1,73 @@
1
+ # ![StepFun logo](https://models.dev/logos/stepfun.svg)StepFun
2
+
3
+ Access 3 StepFun models through Mastra's model router. Authentication is handled automatically using the `STEPFUN_API_KEY` environment variable.
4
+
5
+ Learn more in the [StepFun documentation](https://platform.stepfun.com/docs/zh/overview/concept).
6
+
7
+ ```bash
8
+ STEPFUN_API_KEY=your-api-key
9
+ ```
10
+
11
+ ```typescript
12
+ import { Agent } from "@mastra/core/agent";
13
+
14
+ const agent = new Agent({
15
+ id: "my-agent",
16
+ name: "My Agent",
17
+ instructions: "You are a helpful assistant",
18
+ model: "stepfun/step-1-32k"
19
+ });
20
+
21
+ // Generate a response
22
+ const response = await agent.generate("Hello!");
23
+
24
+ // Stream a response
25
+ const stream = await agent.stream("Tell me a story");
26
+ for await (const chunk of stream) {
27
+ console.log(chunk);
28
+ }
29
+ ```
30
+
31
+ > **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [StepFun documentation](https://platform.stepfun.com/docs/zh/overview/concept) for details.
32
+
33
+ ## Models
34
+
35
+ | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
36
+ | ------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
+ | `stepfun/step-1-32k` | 33K | | | | | | $2 | $10 |
38
+ | `stepfun/step-2-16k` | 16K | | | | | | $5 | $16 |
39
+ | `stepfun/step-3.5-flash` | 256K | | | | | | $0.10 | $0.29 |
40
+
41
+ ## Advanced Configuration
42
+
43
+ ### Custom Headers
44
+
45
+ ```typescript
46
+ const agent = new Agent({
47
+ id: "custom-agent",
48
+ name: "custom-agent",
49
+ model: {
50
+ url: "https://api.stepfun.com/v1",
51
+ id: "stepfun/step-1-32k",
52
+ apiKey: process.env.STEPFUN_API_KEY,
53
+ headers: {
54
+ "X-Custom-Header": "value"
55
+ }
56
+ }
57
+ });
58
+ ```
59
+
60
+ ### Dynamic Model Selection
61
+
62
+ ```typescript
63
+ const agent = new Agent({
64
+ id: "dynamic-agent",
65
+ name: "Dynamic Agent",
66
+ model: ({ requestContext }) => {
67
+ const useAdvanced = requestContext.task === "complex";
68
+ return useAdvanced
69
+ ? "stepfun/step-3.5-flash"
70
+ : "stepfun/step-1-32k";
71
+ }
72
+ });
73
+ ```
@@ -0,0 +1,79 @@
1
+ # ![submodel logo](https://models.dev/logos/submodel.svg)submodel
2
+
3
+ Access 9 submodel models through Mastra's model router. Authentication is handled automatically using the `SUBMODEL_INSTAGEN_ACCESS_KEY` environment variable.
4
+
5
+ Learn more in the [submodel documentation](https://submodel.gitbook.io).
6
+
7
+ ```bash
8
+ SUBMODEL_INSTAGEN_ACCESS_KEY=your-api-key
9
+ ```
10
+
11
+ ```typescript
12
+ import { Agent } from "@mastra/core/agent";
13
+
14
+ const agent = new Agent({
15
+ id: "my-agent",
16
+ name: "My Agent",
17
+ instructions: "You are a helpful assistant",
18
+ model: "submodel/Qwen/Qwen3-235B-A22B-Instruct-2507"
19
+ });
20
+
21
+ // Generate a response
22
+ const response = await agent.generate("Hello!");
23
+
24
+ // Stream a response
25
+ const stream = await agent.stream("Tell me a story");
26
+ for await (const chunk of stream) {
27
+ console.log(chunk);
28
+ }
29
+ ```
30
+
31
+ > **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [submodel documentation](https://submodel.gitbook.io) for details.
32
+
33
+ ## Models
34
+
35
+ | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
36
+ | -------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
+ | `submodel/deepseek-ai/DeepSeek-R1-0528` | 75K | | | | | | $0.50 | $2 |
38
+ | `submodel/deepseek-ai/DeepSeek-V3-0324` | 75K | | | | | | $0.20 | $0.80 |
39
+ | `submodel/deepseek-ai/DeepSeek-V3.1` | 75K | | | | | | $0.20 | $0.80 |
40
+ | `submodel/openai/gpt-oss-120b` | 131K | | | | | | $0.10 | $0.50 |
41
+ | `submodel/Qwen/Qwen3-235B-A22B-Instruct-2507` | 262K | | | | | | $0.20 | $0.30 |
42
+ | `submodel/Qwen/Qwen3-235B-A22B-Thinking-2507` | 262K | | | | | | $0.20 | $0.60 |
43
+ | `submodel/Qwen/Qwen3-Coder-480B-A35B-Instruct-FP8` | 262K | | | | | | $0.20 | $0.80 |
44
+ | `submodel/zai-org/GLM-4.5-Air` | 131K | | | | | | $0.10 | $0.50 |
45
+ | `submodel/zai-org/GLM-4.5-FP8` | 131K | | | | | | $0.20 | $0.80 |
46
+
47
+ ## Advanced Configuration
48
+
49
+ ### Custom Headers
50
+
51
+ ```typescript
52
+ const agent = new Agent({
53
+ id: "custom-agent",
54
+ name: "custom-agent",
55
+ model: {
56
+ url: "https://llm.submodel.ai/v1",
57
+ id: "submodel/Qwen/Qwen3-235B-A22B-Instruct-2507",
58
+ apiKey: process.env.SUBMODEL_INSTAGEN_ACCESS_KEY,
59
+ headers: {
60
+ "X-Custom-Header": "value"
61
+ }
62
+ }
63
+ });
64
+ ```
65
+
66
+ ### Dynamic Model Selection
67
+
68
+ ```typescript
69
+ const agent = new Agent({
70
+ id: "dynamic-agent",
71
+ name: "Dynamic Agent",
72
+ model: ({ requestContext }) => {
73
+ const useAdvanced = requestContext.task === "complex";
74
+ return useAdvanced
75
+ ? "submodel/zai-org/GLM-4.5-FP8"
76
+ : "submodel/Qwen/Qwen3-235B-A22B-Instruct-2507";
77
+ }
78
+ });
79
+ ```