Serveur MCP

Connectez Claude Code, Cursor, Codex, VS Code et d'autres clients MCP aux modèles d'image et de vidéo de SeedRouter avec votre clé API.

SeedRouter héberge un serveur distant Model Context Protocol. Un agent IA peut l'utiliser pour lister les modèles d'image et de vidéo, consulter leurs schémas de requête et leurs tarifs, soumettre des tâches de génération et récupérer les résultats, sans que vous ayez à écrire de code d'intégration.

https://api.seedrouter.ai/v1/mcp

Transport : Streamable HTTP, sans état. Le serveur prend en charge la version 2026-07-28 du protocole et les versions antérieures qui commencent par une négociation initialize, jusqu'à 2024-11-05.
Authentification : votre clé API SeedRouter sous forme de jeton Bearer, Authorization: Bearer YOUR_API_KEY. Créez-en une sur la page Clés API ; voir Authentification.
Facturation : identique à celle de l'API HTTP. Chaque appel à submit_task correspond à une requête au point de terminaison de tâche concerné et est facturé de la même manière.

Les clients qui permettent uniquement de se connecter avec OAuth, sans champ pour un en-tête personnalisé, ne peuvent pas encore se connecter.

Connecter un client

La page Clés API propose un bouton Se connecter via MCP qui renseigne l'une de vos clés pour chaque client ci-dessous.

Claude Code

claude mcp add --transport http seedrouter https://api.seedrouter.ai/v1/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Ajoutez ceci à ~/.cursor/mcp.json, ou à .cursor/mcp.json dans un projet :

{
  "mcpServers": {
    "seedrouter": {
      "url": "https://api.seedrouter.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Codex CLI

Codex lit la clé depuis une variable d'environnement :

export SEEDROUTER_API_KEY=YOUR_API_KEY
codex mcp add seedrouter --url https://api.seedrouter.ai/v1/mcp \
  --bearer-token-env-var SEEDROUTER_API_KEY

Codex enregistre le nom de la variable, pas la clé. Démarrez Codex depuis un shell où SEEDROUTER_API_KEY est définie, par exemple en l'exportant dans le fichier de profil de votre shell.

VS Code

Ajoutez ceci à .vscode/mcp.json :

{
  "servers": {
    "seedrouter": {
      "type": "http",
      "url": "https://api.seedrouter.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Tout autre client prenant en charge les serveurs distants Streamable HTTP avec un en-tête Authorization personnalisé se configure de la même manière.

Outils

Outil	Fonction	Déduction du solde
`list_models`	Liste les identifiants de modèles acceptés par `submit_task`, chacun avec un lien vers sa documentation. `endpoint` facultatif : `images` ou `videos`.	Non
`get_model_schema`	Renvoie le JSON Schema du corps de requête d'un modèle. Les règles que JSON Schema ne peut pas exprimer, comme les exigences conditionnelles et les limites entre champs, sont appliquées par l'API et décrites sur la page de documentation du modèle.	Non
`get_pricing`	Renvoie les tarifs catalogue actuels d'un modèle en USD, à partir des mêmes tarifs à jour que ceux utilisés pour la facturation, y compris les éventuels niveaux tarifaires des modèles.	Non
`submit_task`	Soumet une tâche : `model` et `input`, le corps de requête décrit par `get_model_schema`. Renvoie un identifiant de tâche.	Oui, pour chaque appel qui crée une tâche
`get_task`	Renvoie l'état et le résultat d'une tâche. Le paramètre facultatif `wait_seconds` (0–50) permet d'attendre sur le serveur tant que la tâche est en cours d'exécution.	Non
`get_balance`	Renvoie le solde restant, en USD, du compte auquel appartient la clé.	Non

submit_task n'est pas idempotent. Répéter un appel crée et facture une deuxième tâche ; vérifiez donc get_task, get_balance ou votre historique des tâches avant de répéter un appel dont vous n'avez pas reçu le résultat.

Déroulement type

Appelez list_models avec endpoint: "images".
Appelez get_model_schema pour le modèle choisi.
Si vous le souhaitez, appelez get_pricing pour consulter d'abord le tarif.
Appelez submit_task avec model et un input conforme au schéma.
Appelez get_task avec wait_seconds: 50, en répétant l'appel tant que status vaut processing, puis lisez output. Les tâches Seedance indiquent queued et running avant succeeded.

La génération est asynchrone, exactement comme dans l'API HTTP : submit_task renvoie une réponse dès que la tâche est acceptée. wait_seconds évite à l'agent d'interroger la tâche en boucle, mais une longue vidéo peut tout de même nécessiter plusieurs appels à get_task. Si une vérification de l'état échoue pour une raison temporaire pendant l'attente, comme une limitation du débit ou une erreur du serveur, get_task renvoie le dernier résultat processing au lieu de l'erreur ; appelez-le à nouveau.

Règles reprises de l'API HTTP

Les images, vidéos et fichiers audio de référence doivent être des URL http(s) publiques. Les entrées en Base64 sont refusées.
Lorsque l'API HTTP répond, son corps de réponse constitue le résultat de l'outil, sans modification, avec les mêmes codes d'erreur. Les erreurs qui surviennent avant qu'une requête ne lui parvienne, comme un modèle inconnu ou des arguments d'outil invalides, sont renvoyées sous forme d'un simple message d'erreur. Une clé refusée sur le point de terminaison MCP lui-même entraîne un statut HTTP 401.
Les tâches échouées ne sont pas facturées.
Par défaut, un compte peut avoir jusqu'à 50 tâches d'image et de vidéo en cours simultanément. Les soumissions supplémentaires renvoient HTTP 429 avec le code 30002 jusqu'à ce que des tâches en cours se terminent ; voir Utiliser SeedRouter depuis des agents IA.
Les identifiants de modèles et les paramètres sont ceux de la documentation de chaque modèle. Un modèle apparaît dans list_models dès qu'il est disponible sur l'API.
Les modèles de texte ne sont pas proposés via MCP. Appelez-les sur les points de terminaison texte, ou utilisez-les pour exécuter un agent de programmation, comme décrit dans Agents de programmation sur SeedRouter.

On this page