FreeModel

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

Pour en savoir plus, consultez la documentation FreeModel.

.env

FREEMODEL_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: "freemodel/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 FreeModel pour plus de détails.

Modèles

10 available models

Model	Context	Tools	Reasoning	Image	Audio	Video	Input $/1M	Output $/1M
freemodel/claude-fable-5	1.0M						$10	$50
freemodel/claude-haiku-4-5-20251001	200K						$1	$5
freemodel/claude-opus-4-6	1.0M						$5	$25
freemodel/claude-opus-4-7	1.0M						$5	$25
freemodel/claude-opus-4-8	1.0M						$5	$25
freemodel/claude-sonnet-4-6	1.0M						$3	$15
freemodel/gpt-5.3-codex	400K						$2	$14
freemodel/gpt-5.4	1.1M						$3	$15
freemodel/gpt-5.4-mini	400K						$0.75	$5
freemodel/gpt-5.5	1.1M						$5	$30

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://cc.freemodel.dev/v1",
    id: "freemodel/claude-fable-5",
    apiKey: process.env.FREEMODEL_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
      ? "freemodel/gpt-5.5"
      : "freemodel/claude-fable-5";
  }
});

Installation directe du Provider

Ce Provider peut aussi être installé directement comme package autonome, utilisable à la place de la chaîne du routeur de modèles Mastra. Consultez la documentation du package pour plus de détails.

npm

npm install @ai-sdk/anthropic

pnpm

pnpm add @ai-sdk/anthropic

Yarn

yarn add @ai-sdk/anthropic

Bun

bun add @ai-sdk/anthropic