Para equipas que constroem em Moçambique

Integre inteligência artificiale pague em meticais

A TipoChat API devolve respostas de texto com crédito pré-pago, cobrança auditável ao micro-metical e repetição segura para a sua aplicação.

Ver documentaçãoComo funciona o piloto

Piloto técnico validado · primeira chamada faturável custou0,0094 MZN

Exemplo de pedido HTTP à API TipoChat e respetiva resposta em JSON.
tipo-textPOST /v1/responses
curl https://api.tipochat.co.mz/v1/responses \  -H "Authorization: Bearer tc_live_7f2a…" \  -H "Idempotency-Key: 6be4c7eb-5319-4148…" \  -d '{       "model": "tipo-text",       "input": "Escreve uma saudação curta.",       "max_output_tokens": 180     }'
200412 msx-request-id: req_01JD7K2M4P
{  "model": "tipo-text",  "output_text": "Olá! Como posso ajudar?",  "usage": { "input_tokens": 15, "output_tokens": 8 },  "billing": { "currency": "MZN", "charged_micro_mzn": 9400 }}
Resposta200 · cobrada por uso real

Tecnologia e regras do piloto

  • M-Pesa
  • e-Mola
  • Idempotência
  • Ledger imutável
  • micro-MZN
  • Sandbox

Tudo o que a API precisa de ser: aborrecida.

Fiabilidade, visibilidade e segurança, sem configuração.

Um contrato, sem surpresas

Texto síncrono, sem streaming nesta primeira etapa — porque não se transmite conteúdo pago antes de existir forma testada de medir o uso real.

Exemplo de pedido HTTP à API TipoChat e respetiva resposta em JSON.
tipo-textPOST /v1/responses
curl https://api.tipochat.co.mz/v1/responses \  -H "Authorization: Bearer tc_live_7f2a…" \  -H "Idempotency-Key: 6be4c7eb-5319-4148…" \  -d '{       "model": "tipo-text",       "input": "Escreve uma saudação curta.",       "max_output_tokens": 180     }'
200412 msx-request-id: req_01JD7K2M4P
{  "model": "tipo-text",  "output_text": "Olá! Como posso ajudar?",  "usage": { "input_tokens": 15, "output_tokens": 8 },  "billing": { "currency": "MZN", "charged_micro_mzn": 9400 }}
Resposta200 · cobrada por uso real

Repita o pedido. Não repita a cobrança.

Se a rede falhar e a sua aplicação tentar de novo, o mesmo corpo devolve a resposta já guardada, sem custo adicional.

  • 200Mesma chave, mesmo corpo
  • 409Mesma chave, corpo diferente
  • 409Mesma chave, ainda em curso
Contrato directo

Um pedido JSON para um endpoint de respostas, sem uma camada de cliente obrigatória.

Integração simples

Use HTTP a partir do servidor que já mantém. Os exemplos podem ser copiados e adaptados.

Chaves de servidor

A chave Bearer fica no seu servidor e nunca deve ser enviada para o browser ou aplicação distribuída.

Cobrança por uso

O custo é calculado por pedido e liquidado com crédito pré-pago em meticais.

Uso rastreável

Cada resposta traz um identificador, uso de tokens e custo para facilitar o seu diagnóstico.

Documentação concreta

Referência do endpoint, exemplos HTTP e explicação clara dos erros e da repetição segura.

Construa em minutos.

Um contrato de pedido e resposta, uma chave de servidor e um livro de movimentos que não se pode alterar. Nada mais para instalar.

  1. 01

    Receba a chave

    Ambientes de teste e produção separados. As chaves são emitidas pelo TipoChat durante o piloto — não há portal nem venda automática.

  2. 02

    Chame a API

    Envie a chave apenas a partir do seu servidor, com uma chave de idempotência por operação. Nunca no browser nem numa aplicação distribuída.

  3. 03

    Acompanhe o uso

    Cada resposta traz uso, custo e identificador de pedido. O painel de consumo abre quando o acesso comercial abrir.

Diagrama: o servidor do cliente chama api.tipochat.co.mz, que autentica a chave, reserva saldo, chama o modelo e liquida o custo real.
O seu servidor
api.tipochat.co.mzAutenticado
tipo-text
Carteira e ledger
  • REST
  • JSON
  • cURL
  • Node.js
  • Python
  • PHP
Crédito pré-pago e cobrança por uso
MZNCrédito pré-pago e cobrança por uso
Um endpoint público de respostas
RESTUm endpoint público de respostas
Pedido e resposta síncronos
JSONPedido e resposta síncronos
Idempotência por pedido
IDIdempotência por pedido

Três integrações que pode copiar hoje

Cada uma usa o mesmo endpoint e o mesmo contrato. Muda apenas o que se escreve em «instructions».

PedidoPOST /v1/responses
{  "instructions": "Classifique em: FATURACAO, SUPORTE, VENDAS. Responda só com o rótulo.",  "input": "Fui cobrado duas vezes este mês e quero o reembolso."}
Resposta200usage: 38 entrada · 3 saída
FATURACAO
01

Classificar mensagens que chegam

Defina as categorias dentro de «instructions» e peça só o rótulo de volta. Sem treino, sem dados rotulados, sem infraestrutura.

Para casos difíceis, peça o raciocínio antes do rótulo e leia apenas a última linha — acerta mais, custa mais tokens.

O modelo devolve texto. Compare com a sua lista de categorias e trate o que não corresponder.

PedidoPOST /v1/responses
{  "instructions": "Resuma em três secções: Decisão, Prazo, Responsável.",  "input": "Ata da reunião de 12 de março…"}
Resposta200usage: 1.204 entrada · 96 saída
Decisão: avançar com o piloto…
02

Resumir documentos longos com estrutura fixa

Um resumo livre é difícil de usar a jusante. Diga exatamente que secções quer e recebe sempre o mesmo formato.

O limite de entrada é 8.000 caracteres. Documentos maiores precisam de ser divididos e resumidos por partes.

PedidoPOST /v1/responses
{  "instructions": "Extraia nome, valor e data. Devolva apenas JSON válido.",  "input": "Recibo: Ana Come, 1.250 MT, 04/08/2026"}
Resposta200usage: 46 entrada · 28 saída
{"nome":"Ana Come","valor":1250,"data":"2026-08-04"}
03

Extrair campos para o seu sistema

Peça JSON e valide-o do seu lado.

O tipo-text não tem modo JSON garantido: devolve texto. Faça o parse dentro de um try, e se falhar repita o pedido com uma chave de idempotência nova — repetir com a mesma chave devolveria o mesmo texto inválido.

Um corpo diferente com a mesma chave de idempotência é recusado com 409.

Uma resposta com quinze tokens de entrada e oito de saída debitou 9.400 micro-MZN de uma carteira de teste. A repetição com a mesma chave de idempotência devolveu a resposta guardada, sem nova chamada ao fornecedor.
Registo do piloto técnico interno4 de agosto de 2026 · api/README.md

0,0094

MZN

Custo da primeira chamada faturável

Pague apenas pelo uso da API

Não há mensalidade, plano nem recarga automática. O saldo é adicionado quando a equipa precisa e cada pedido fica auditável.

Sandbox

Para avaliar o contrato

Disponível agora

Começar na documentação
  • Respostas de teste idempotentes
  • Custo zero, saldo não é tocado
  • Contrato igual ao de produção
  • Documentação pública completa

Saldo pré-pago

Como funciona

Para usar a API em produção

Piloto por convite

Pedir acesso ao piloto
  • Chave de produção emitida pelo TipoChat
  • Carteira pré-paga em micro-MZN
  • Reserva, liquidação e devolução
  • Recargas M-Pesa e e-Mola em validação final
  • Suporte direto durante o piloto

Operação da equipa

Para gestão e auditoria do uso

Disponível no portal

Falar connosco
  • Até 20 chaves API ativas
  • Até 20 membros por organização
  • Registos de conteúdo por 30 dias
  • Histórico de saldo e pagamentos

Streaming, voz e imagens não fazem parte da API nesta fase.

Abrimos com responsabilidade.

O piloto valida consumo, recargas e suporte antes da abertura comercial. A documentação pública mostra exatamente o que existe hoje — e o que ainda não existe.

Ver estado do serviço
Chave só de servidor
Guardamos apenas o SHA-256 do segredo
Webhooks validados
Assinatura HMAC antes de creditar saldo
Ledger imutável
Sem UPDATE, DELETE ou TRUNCATE

Perguntas frequentes

Se faltar alguma coisa, a documentação pública descreve o contrato completo, os limites e os erros.

Ler documentaçãoVer estado

  • É o nome estável do produto de texto da TipoChat API. Recebe um pedido em texto e devolve uma resposta em texto, de forma síncrona. É o único modelo aceite pelo endpoint nesta fase.

  • Ainda não. A API está em piloto controlado: não existe portal, venda automática nem recarga pública. As chaves são emitidas pelo TipoChat durante o piloto.

  • Não nesta versão. Não se transmite conteúdo pago antes de existir uma forma testada de terminar o stream, medir o uso real e liquidar a carteira mesmo se o cliente se desligar.

  • Não. Uma chave nunca deve entrar no browser, numa aplicação móvel distribuída, num repositório ou numa variável pública. Cada integração deve chamar a API a partir do seu próprio servidor.

  • Cada pedido leva uma chave de idempotência. O mesmo corpo com a mesma chave devolve a resposta guardada, sem novo débito. Um corpo diferente com a mesma chave é recusado com 409 em vez de ser cobrado duas vezes.

  • Com saldo pré-pago em meticais. As recargas por M-Pesa e e-Mola estão publicadas e em validação final; as vendas continuam fechadas até uma recarga real controlada ser reconciliada.

Comece pelo sandbox

O sandbox devolve respostas idempotentes de custo zero, com o mesmo contrato da produção. É o caminho mais curto para perceber se a API serve o seu produto.

Abrir documentaçãoVer estado do serviço