TopxAI Models

npx add-mcp 'https://ai.topxea.com/mcp/models'

Use o catálogo TopxAI de dentro do Claude Code, Cursor, VS Code ou qualquer cliente que fale o Model Context Protocol. Os servidores autenticam com a mesma chave de API que a API, cobram os mesmos preços e adicionam uma pequena taxa fixa por chamada de ferramenta.

Como é cobrado

• Uma chamada de ferramenta que chega a um modelo é cobrada exatamente como a mesma solicitação feita pela API, mais a taxa fixa de chamada do servidor pelo qual passou.
• Uma chamada que o provedor falha não é cobrada: nem o preço do modelo nem a taxa de chamada.
• Um trabalho de vídeo que o provedor falha após aceitá-lo é reembolsado integralmente.
• Cada resposta informa o valor exato cobrado, e cada chamada aparece no log de uso com sua taxa de chamada como uma linha separada.

Servidores

TopxAI Models

Pergunte a qualquer modelo de texto do catálogo de dentro da conversa de outro modelo: uma segunda opinião, uma revisão ou um modelo que o host não possui.

Endpoint https://ai.topxea.com/mcp/models · $0,001 por chamada

Ferramenta	O que faz
list_models	Lista os modelos de texto que esta chave de API pode consultar, com seus preços em USD por milhão de tokens e a taxa de chamada.
ask_model	Envia um prompt para um modelo de texto do catálogo TopxAI e retorna sua resposta. Cobrado pelo preço de tokens do modelo mais uma taxa de chamada de $0,001; a resposta informa o valor exato cobrado.
judge	Pergunta ao Jev da TypeSafe (um modelo System One) perguntas tipadas sobre um trecho de texto e retorna números calibrados, não prosa: uma probabilidade para uma pergunta de sim/não (tipo noul), uma opção com probabilidade por opção (tipo choice, com critérios) ou um valor em uma escala com probabilidade por âncora (tipo score, com âncoras). Cobrado pelo preço de tokens de entrada do Jev mais uma taxa de chamada de $0,001.

Exemplo: list_models

Você diz: Quais modelos posso consultar através da TopxAI e quanto custam?

Chamada de ferramenta:

{"arguments":{},"name":"list_models"}

Resultado:

{"call_fee_usd":0.001,"models":[{"input_usd_per_million_tokens":5,"model":"gpt-6-astra","output_usd_per_million_tokens":25,"route":"openai-shared","unit":"per_million_tokens"}]}

Exemplo: ask_model

Você diz: Peça ao GPT-6 uma segunda opinião sobre este plano de migração e liste os riscos que ele vê.

Chamada de ferramenta:

{"arguments":{"max_cost_usd":0.05,"max_output_tokens":1024,"model":"gpt-6-astra","prompt":"Review this migration plan for risks: …"},"name":"ask_model"}

Resultado:

{"call_fee_usd":0.001,"charged":true,"charged_usd":0.01026,"finish_reason":"stop","model":"gpt-6-astra","request_id":"2026092208…","route":"openai-shared","usage":{"completion_tokens":288,"prompt_tokens":412}}

Exemplo: judge

Você diz: Use o Jev para dizer se este ticket de suporte é urgente e sobre o que se trata.

Chamada de ferramenta:

{"arguments":{"questions":{"topic":{"criteria":{"account_access":"Login, password, permissions","billing":"Charges, invoices, refunds","integration":"Connecting a payment provider or an API","other":null},"instructions":"What is the message about?","type":"choice"},"urgency":{"instructions":"Does this message express urgency?","type":"noul"}},"state":"Hi, I have been trying to connect my Stripe account for 3 days and it keeps failing. I am losing sales. Please help ASAP."},"name":"judge"}

Resultado:

{"answers":{"topic":{"choice":"integration","confidence":1,"probabilities":{"account_access":0,"billing":0,"integration":1,"other":0},"type":"choice"},"urgency":{"noul":0.98,"type":"noul"}},"call_fee_usd":0.001,"charged":true,"charged_usd":0.00102,"model":"jev-1.13.0","request_id":"2026092208…","route":"typesafe-official","usage":{"input_tokens":447}}

TopxAI Images

Gere imagens com o modelo de imagem do catálogo e receba-as inline.

Endpoint https://ai.topxea.com/mcp/images · $0,01 por chamada

Ferramenta	O que faz
generate_image	Gera uma ou mais imagens a partir de um prompt com o modelo de imagem TopxAI. Cobrado pelo preço por solicitação do modelo mais uma taxa de chamada de $0,01. Retorna as imagens inline e como links assinados temporários válidos por até uma hora; a capacidade do cache pode expirá-los antes.

Exemplo: generate_image

Você diz: Desenhe um pôster de uma raposa na neve, paisagem.

Chamada de ferramenta:

{"arguments":{"n":1,"prompt":"A fox in the snow, poster style","size":"1536x1024"},"name":"generate_image"}

Resultado:

{"call_fee_usd":0.01,"charged":true,"charged_usd":0.06,"images":1,"model":"gpt-image-2.5-sunburst","n":1,"request_id":"2026092208…","size":"1536x1024","urls":["https://ai.topxea.com/v1/images/content/…"]}

TopxAI Videos

Envie um trabalho de geração de vídeo e faça polling até o clipe estar pronto.

Endpoint https://ai.topxea.com/mcp/videos · $0,01 por chamada

Ferramenta	O que faz
generate_video	Envia um trabalho de texto para vídeo. Cobrado por segundo da duração solicitada mais uma taxa de chamada de $0,01 quando o provedor aceita o trabalho; um trabalho que falha é reembolsado. Faça polling de video_status com o request_id retornado.
video_status	Informa o status de um trabalho de vídeo enviado com generate_video. Gratuito. Quando o status é done, content_url serve o clipe para a mesma chave de API.

Exemplo: generate_video

Você diz: Faça um clipe de 8 segundos em 720p de ondas ao entardecer.

Chamada de ferramenta:

{"arguments":{"duration":8,"prompt":"Waves at dusk, slow motion","resolution":"720p"},"name":"generate_video"}

Resultado:

{"billing_request_id":"2026092208…","call_fee_usd":0.01,"charged":true,"charged_usd":0.81,"duration":8,"model":"grok-imagine-video-1.5","request_id":"vid_8f3…","resolution":"720p","status":"pending"}

Exemplo: video_status

Você diz: O vídeo já está pronto?

Chamada de ferramenta:

{"arguments":{"request_id":"vid_8f3…"},"name":"video_status"}

Resultado:

{"content_url":"https://ai.topxea.com/v1/videos/vid_8f3…/content","progress":100,"request_id":"vid_8f3…","status":"done"}

Conectar

Todo cliente usa a URL do servidor com a chave de API no cabeçalho Authorization. Com o Claude Code:

claude mcp add --transport http topxai-models https://ai.topxea.com/mcp/models --header "Authorization: Bearer sk-your-key"

O Cursor lê o mesmo servidor de .cursor/mcp.json e o VS Code de .vscode/mcp.json; a página do aplicativo preenche os trechos com uma de suas próprias chaves.

Obtenha uma chave de API · Preço de cada modelo · Documentação · TopxAI