Utiliser SeedRouter depuis des agents IA

Un agent peut utiliser SeedRouter de trois manières. Elles partagent la même clé API, le même solde, les mêmes modèles et les mêmes limites, et sont facturées de la même façon.

Pour exécuter l'agent lui-même sur les modèles de texte de SeedRouter, voir Agents de programmation sur SeedRouter.

Définir votre clé une seule fois

Créez une clé sur la page Clés API et exportez-la pour que l'agent puisse la lire sans qu'elle se retrouve dans les fichiers de votre projet :

export SEEDROUTER_API_KEY=YOUR_API_KEY

La page Clés API propose également un bouton Se connecter via MCP qui affiche une configuration prête à l'emploi pour chaque client MCP.

Ce qu'un agent fait sur SeedRouter

1. Trouver un modèle : list_models via MCP, ou la liste des modèles dans /llms.txt. Chaque modèle disposant d'une page de présentation possède un résumé en texte brut à l'adresse https://seedrouter.ai/models/<slug>/llms.txt, avec ses paramètres, ses tarifs et des exemples.
2. Lire son schéma d'entrée : get_model_schema via MCP, ou la page de documentation du modèle.
3. Utiliser des URL de médias publiques : les points de terminaison de génération acceptent les images, vidéos et fichiers audio de référence uniquement sous forme d'URL http(s) publiques. Les entrées en Base64 sont refusées ; hébergez donc d'abord les fichiers locaux à un emplacement accessible.
4. Vérifier le tarif : get_pricing via MCP renvoie les tarifs actuels du modèle en USD avant toute soumission.
5. Soumettre et attendre : submit_task, puis get_task avec wait_seconds: 50 jusqu'à la fin de la tâche. Via HTTP, soumettez la requête au point de terminaison du modèle et interrogez GET /v1/tasks/{id} environ toutes les trois secondes.

Les tâches échouées ne sont pas facturées. Une soumission n'est pas idempotente : répéter une requête dont vous n'avez pas reçu la réponse crée et facture une deuxième tâche ; vérifiez donc d'abord votre historique des tâches ou votre solde.

Limites à prendre en compte

Les requêtes peuvent aussi être soumises à une limitation du débit, qui renvoie également HTTP 429. En cas de statut HTTP 429, respectez le délai de Retry-After si cet en-tête est présent ; sinon, augmentez le délai de façon exponentielle à chaque nouvelle tentative, avec une variation aléatoire et un délai maximal. Basez votre décision sur le code de statut plutôt que sur l'analyse des corps d'erreur, car les points de terminaison texte répondent dans le format d'erreur de leur protocole. Un traitement par lots doit conserver une file d'attente et soumettre de nouvelles tâches à mesure que celles en cours se terminent, au lieu de tout envoyer en même temps. Contactez [email protected] si vous avez besoin d'une limite plus élevée.

Points d'entrée lisibles par machine