Usar o SeedRouter com agentes de IA

Um agente pode usar o SeedRouter de três formas. Todas compartilham a mesma chave de API, saldo, modelos e limites, e são cobradas da mesma forma.

Para executar o próprio agente com os modelos de texto do SeedRouter, veja Agentes de programação no SeedRouter.

Configure sua chave uma única vez

Crie uma chave na página de chaves de API e exporte-a para que o agente possa lê-la sem que ela fique nos arquivos do seu projeto:

export SEEDROUTER_API_KEY=YOUR_API_KEY

A página de chaves de API também tem um botão Conectar via MCP que exibe uma configuração pronta para cada cliente MCP.

O que um agente faz no SeedRouter

1. Encontrar um modelo: list_models via MCP, ou a lista de modelos em /llms.txt. Cada modelo com uma página de apresentação tem um resumo em texto simples em https://seedrouter.ai/models/<slug>/llms.txt com seus parâmetros, preços e exemplos.
2. Ler seu esquema de entrada: get_model_schema via MCP, ou a página de documentação do modelo.
3. Usar URLs públicas para os arquivos de mídia: os endpoints de geração só aceitam imagens, vídeos e áudios de referência como URLs http(s) públicas. Entradas em Base64 são rejeitadas, então primeiro hospede os arquivos locais em algum lugar acessível.
4. Conferir o preço: get_pricing via MCP retorna as tarifas atuais do modelo em USD antes de qualquer envio.
5. Enviar e aguardar: submit_task, depois get_task com wait_seconds: 50 até a tarefa terminar. Via HTTP, envie ao endpoint do modelo e consulte GET /v1/tasks/{id} aproximadamente a cada três segundos.

Tarefas que falham não são cobradas. Um envio não é idempotente: repetir uma requisição cuja resposta você não recebeu cria uma segunda tarefa e desconta seu custo do saldo, então confira seu histórico de tarefas ou saldo primeiro.

Limites a considerar

As requisições também podem estar sujeitas a limites de frequência, que também retornam HTTP 429. Ao receber HTTP 429, aguarde o tempo indicado em Retry-After quando estiver presente; caso contrário, aumente a espera exponencialmente a cada nova tentativa, com um componente aleatório e um tempo máximo. Baseie a decisão no código de status em vez de analisar os corpos de erro, pois os endpoints de texto respondem no formato de erro do seu protocolo. Um processamento em lote deve manter uma fila e enviar novas tarefas à medida que as que estão em execução terminam, em vez de enviar tudo de uma vez. Entre em contato com [email protected] se precisar de um limite maior.

Pontos de entrada legíveis por máquina