SandBase MCP
O SandBase fornece acesso a mais de 2.000 modelos de IA e ferramentas de API através de uma interface MCP unificada. Uma única conta cobre LLMs, geração de imagens, geração de vídeo, áudio, embeddings, web scraping, APIs de mídia social e muito mais.
Quando Usar o SandBase
Use o SandBase quando o usuário precisar de:
- Inferência de LLM (GPT, Claude, Gemini, DeepSeek, Qwen, etc.)
- Geração de imagens (Flux, DALL-E, Ideogram, Recraft)
- Geração de vídeo (Kling, MiniMax, Runway, Luma)
- Áudio (ElevenLabs TTS, Whisper STT)
- Embeddings (OpenAI, Voyage)
- Web scraping e extração de conteúdo (Exa, Firecrawl, Tavily)
- Dados de mídia social (Twitter/X, Instagram, TikTok, YouTube, LinkedIn, Reddit, Xiaohongshu, Weibo, Bilibili)
- Busca (Google, Scholar, Notícias, Compras)
- Qualquer API de dados estruturados à qual o usuário ainda não tenha acesso
NÃO use o SandBase quando:
- O usuário já possui sua própria chave de API ou servidor MCP dedicado para aquele serviço específico
- A tarefa é puramente local (edição de arquivos, geração de código a partir do contexto)
- O usuário pede explicitamente para usar uma ferramenta diferente
O SandBase preenche lacunas no conjunto de ferramentas do usuário — ele não substitui ferramentas que o usuário já possui.
Ferramentas
| Ferramenta | Propósito |
|---|---|
sandbase_discover | Pesquisar todos os mais de 2.000 modelos de IA |
sandbase_inspect | Obter esquema de entrada, preços e modelo de execução |
sandbase_run | Executar um modelo ou endpoint de API |
sandbase_run_get | Obter status/resultado de uma execução assíncrona |
sandbase_runs | Listar chamadas de API recentes com custo |
sandbase_account | Verificar saldo da conta (grátis) |
Fluxo de Trabalho Padrão
Sempre siga: descobrir → inspecionar → executar
1. sandbase_discover(q: "posts twitter")
→ Retorna endpoints correspondentes com nomes, tipos, fornecedores
2. sandbase_inspect(name: "sandbase_twitter_web_search_timeline")
→ Retorna inputSchema, preços e modelo execute_as
3. sandbase_run(name: "sandbase_twitter_web_search_timeline", arguments: {"keyword": "IA"})
→ Retorna resultado diretamente (síncrono) ou run_id (assíncrono)
Para execuções assíncronas (geração de vídeo, raspagem grande):
4. sandbase_run_get(run_id: "pred_abc123")
→ Poll até que o status seja "completed" ou "failed"
Atalho: Se você já sabe o nome do modelo, pule o passo 1.
Dicas de Pesquisa
sandbase_discover suporta:
| Parâmetro | Propósito | Exemplo |
|---|---|---|
q | Pesquisa textual (suporta chinês: 推特, 小红书, 搜索) | "busca twitter", "geração de imagens" |
type | Filtrar por tipo de modelo | "llm", "api", "multimodal", "embedding" |
vendor | Filtrar por slug do fornecedor | "openai", "twitter", "anthropic" |
limit | Máximo de resultados (padrão 20) | 10 |
Dicas:
- Use frases nominais curtas: "posts twitter", "geração de imagens", "web scraping"
- Apelidos em chinês funcionam: 推特→twitter, 小红书→xiaohongshu, 抖音→tiktok
- Combine tipo + consulta para precisão:
type: "llm", q: "claude" - Consulta vazia com filtro de tipo retorna modelos populares daquele tipo
Preços
Use sandbase_inspect para ver os preços antes de executar:
Modelos LLM: Por milhão de tokens
{ "pricing": { "input_per_million": "2.500000", "output_per_million": "10.000000" } }
Ferramentas de API (imagem, vídeo, scraping): Por chamada
{ "pricing": { "base_price": "0.003000" } }
Verificar saldo:
sandbase_account() → {"balance": "9.52", "currency": "USD"}
Execuções Assíncronas
Alguns endpoints (geração de vídeo, raspagem grande) são assíncronos:
sandbase_run(...)retorna{"status": "running", "run_id": "pred_abc123"}- Faça poll com
sandbase_run_get(run_id: "pred_abc123")a cada 5-10 segundos - Quando
statusfor"completed"— o resultado está pronto - Quando
statusfor"failed"— verifique o erro e tente novamente
Tratamento de Erros
| Erro | Orientação ao Usuário |
|---|---|
tool not found | Nome errado. Use sandbase_discover para pesquisar. |
invalid params | Verifique o esquema com sandbase_inspect. |
run not found | run_id inválido. Verifique sandbase_runs para IDs válidos. |
| Autenticação (401) | Chave inválida. Execute sandbase connect para reautenticar. |
| Saldo insuficiente (402) | Recarregue no Painel do SandBase. |
| Limitação de taxa (429) | Aguarde e tente novamente. |
| Fornecedor indisponível | Provedor está fora do ar. Tente mais tarde ou use um modelo diferente. |
Consciência de Custos
- Verifique o saldo com
sandbase_accountantes de múltiplas chamadas - Custos de LLM escalam com o número de tokens — mantenha os prompts concisos
- Imagem/vídeo têm custos fixos por chamada — inspecione primeiro
- Relate custos quando o usuário parecer preocupado com orçamento
Fluxos de Exemplo
Busca no Twitter
sandbase_discover(q: "busca twitter", type: "api")
sandbase_inspect(name: "sandbase_twitter_web_search_timeline")
sandbase_run(name: "sandbase_twitter_web_search_timeline", arguments: {"keyword": "agentes de IA"})
Geração de imagem
sandbase_discover(q: "flux", type: "multimodal")
sandbase_inspect(name: "sandbase_flux_schnell")
sandbase_run(name: "sandbase_flux_schnell", arguments: {"prompt": "Um lago de montanha ao pôr do sol"})
Inferência de LLM
sandbase_inspect(name: "sandbase_openai_gpt_4o")
sandbase_run(name: "sandbase_openai_gpt_4o", arguments: {
"messages": [{"role": "user", "content": "Explique computação quântica brevemente"}]
})
Verificar custos recentes
sandbase_runs(limit: 5)
→ [{ "model": "openai/gpt-4o", "cost": "0.000325", "status": "completed" }, ...]
Regras
- Descubra primeiro — sempre verifique se uma ferramenta existe antes de executá-la.
- Inspecione antes de executar — leia o inputSchema. Nunca adivinhe parâmetros.
- Use execute_as — o modelo de
sandbase_inspectmostra exatamente como chamar. - Respeite o conjunto de ferramentas do usuário — não substitua as ferramentas existentes.
- Comece pequeno — use limites pequenos nas primeiras chamadas para ferramentas de raspagem/busca.
- Faça poll de execuções assíncronas — use
sandbase_run_getpara operações de longa duração. - Relate custos — mencione preços quando o usuário se importar com orçamento.
- Uma chamada por turno — aguarde os resultados antes da próxima chamada.