Ambient

Accédez à 10 modèles Ambient via le routeur de modèles de Mastra. L’authentification est gérée automatiquement à l’aide de la variable d’environnement AMBIENT_API_KEY.

Pour en savoir plus, consultez la documentation Ambient.

.env

AMBIENT_API_KEY=your-api-key

src/mastra/agents/my-agent.ts

import { Agent } from "@mastra/core/agent";

const agent = new Agent({
  id: "my-agent",
  name: "My Agent",
  instructions: "You are a helpful assistant",
  model: "ambient/ambient/large"
});

// Generate a response
const response = await agent.generate("Hello!");

// Stream a response
const stream = await agent.stream("Tell me a story");
for await (const chunk of stream) {
  console.log(chunk);
}

info

Mastra utilise le point de terminaison /chat/completions compatible avec OpenAI. Certaines fonctionnalités propres au Provider peuvent ne pas être disponibles. Consultez la documentation Ambient pour plus de détails.

Modèles

10 available models

Model	Context	Tools	Reasoning	Image	Audio	Video	Input $/1M	Output $/1M
ambient/ambient/large	203K						$1	$4
ambient/deepseek/deepseek-v4-flash	1.0M						$0.14	$0.28
ambient/deepseek/deepseek-v4-flash-0731	1.0M						$0.14	$0.28
ambient/moonshotai/kimi-k2.6	262K						$0.95	$4
ambient/moonshotai/kimi-k2.7-code	262K						$0.70	$4
ambient/stepfun/step-3.7-flash	262K						$0.19	$1
ambient/xiaomi/mimo-v2.5	1.0M						$0.40	$2
ambient/z-ai/glm-5.2	203K						$1	$4
ambient/zai-org/GLM-5.1-FP8	203K						$1	$4
ambient/zai-org/GLM-5.2-FP8	203K						$1	$4

Configuration avancée

En-têtes personnalisés

src/mastra/agents/my-agent.ts

const agent = new Agent({
  id: "custom-agent",
  name: "custom-agent",
  model: {
    url: "https://api.ambient.xyz/v1",
    id: "ambient/ambient/large",
    apiKey: process.env.AMBIENT_API_KEY,
    headers: {
      "X-Custom-Header": "value"
    }
  }
});

Sélection dynamique du modèle

src/mastra/agents/my-agent.ts

const agent = new Agent({
  id: "dynamic-agent",
  name: "Dynamic Agent",
  model: ({ requestContext }) => {
    const useAdvanced = requestContext.task === "complex";
    return useAdvanced
      ? "ambient/zai-org/GLM-5.2-FP8"
      : "ambient/ambient/large";
  }
});