Xpersona

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

Pour en savoir plus, consultez la documentation Xpersona.

.env

XPERSONA_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: "xpersona/claude-fable-5"
});

// 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 Xpersona pour plus de détails.

Modèles

13 available models

Model	Context	Tools	Reasoning	Image	Audio	Video	Input $/1M	Output $/1M
xpersona/claude-fable-5	1.0M						$3	$19
xpersona/claude-haiku-4-5	200K						$0.60	$4
xpersona/claude-opus-4-8	200K						$2	$9
xpersona/claude-sonnet-4-6	200K						$0.90	$6
xpersona/gemini-3.5-flash	1.0M						$2	$12
xpersona/gpt-5.4	1.1M						$0.75	$6
xpersona/gpt-5.4-mini	272K						$0.38	$4
xpersona/gpt-5.5	1.1M						$2	$12
xpersona/gpt-5.6	372K						$2	$12
xpersona/gpt-5.6-sol	372K						$2	$12
xpersona/gpt-5.6-terra	372K						$2	$2
xpersona/xpersona-frieren-coder	1.0M						$2	$6
xpersona/xpersona-gpt-5.5	1.0M						$3	$18

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://www.xpersona.co/v1",
    id: "xpersona/claude-fable-5",
    apiKey: process.env.XPERSONA_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
      ? "xpersona/xpersona-gpt-5.5"
      : "xpersona/claude-fable-5";
  }
});