Usare SeedRouter dagli agenti IA

Un agente può usare SeedRouter in tre modi. Condividono la stessa chiave API, lo stesso saldo, gli stessi modelli e limiti e vengono addebitati allo stesso modo.

Per eseguire l'agente stesso sui modelli di testo di SeedRouter, vedi Agenti di programmazione su SeedRouter.

Impostare la chiave una sola volta

Crea una chiave nella pagina Chiavi API ed esportala, così l'agente può leggerla senza che finisca nei file del progetto:

export SEEDROUTER_API_KEY=YOUR_API_KEY

La pagina Chiavi API ha anche un pulsante Connetti tramite MCP che mostra una configurazione pronta per ciascun client MCP.

Cosa fa un agente su SeedRouter

1. Trova un modello: list_models tramite MCP, oppure l'elenco dei modelli in /llms.txt. Ogni modello con una pagina di presentazione ha un riepilogo in testo semplice in https://seedrouter.ai/models/<slug>/llms.txt, con parametri, prezzi ed esempi.
2. Legge lo schema di input: get_model_schema tramite MCP, oppure la pagina di documentazione del modello.
3. Usa URL pubblici per i contenuti multimediali: gli endpoint di generazione accettano immagini, video e audio di riferimento solo come URL http(s) pubblici. Gli input in Base64 vengono rifiutati, quindi prima ospita i file locali in un percorso raggiungibile.
4. Controlla il prezzo: get_pricing tramite MCP restituisce le tariffe correnti del modello in USD prima di qualsiasi invio.
5. Invia e attende: submit_task, poi get_task con wait_seconds: 50 finché l'attività non termina. Tramite HTTP, invia all'endpoint del modello ed esegui il polling di GET /v1/tasks/{id} circa ogni tre secondi.

Le attività fallite non vengono addebitate. Un invio non è idempotente: ripetere una richiesta di cui non hai ricevuto la risposta crea e addebita una seconda attività, quindi controlla prima lo storico delle attività o il saldo.

Limiti da considerare

Le richieste possono anche essere soggette a limiti di frequenza, che restituiscono anch'essi HTTP 429. In caso di HTTP 429, rispetta l'attesa indicata da Retry-After quando è presente; altrimenti aumenta l'attesa in modo esponenziale a ogni tentativo, con una variazione casuale e un tempo massimo. Basa la decisione sul codice di stato anziché analizzare i corpi degli errori, perché gli endpoint di testo rispondono nel formato di errore del proprio protocollo. Un processo in batch dovrebbe mantenere una coda e inviare nuove attività man mano che quelle in corso terminano, anziché inviare tutto contemporaneamente. Contatta [email protected] se hai bisogno di un limite più alto.

Punti di accesso leggibili dalle macchine