Início rápido

Faça um pedido de texto à API TipoChat em poucos minutos. O acesso continua controlado durante o piloto.

1. 1

   Receba uma chave de projeto

   Um utilizador com permissão de gestão cria uma chave no dashboard. O segredo é mostrado apenas uma vez; guarde-o num gestor de segredos do servidor.

   TIPOCHAT_API_KEY=tc_live_…
2. 2

   Envie um pedido

   Envie a chave em Authorization e um UUID novo em Idempotency-Key.

   Copiar

   curl https://api.tipochat.co.mz/v1/responses \
     -X POST \
     -H "Authorization: Bearer $TIPOCHAT_API_KEY" \
     -H "Content-Type: application/json" \
     -H "Idempotency-Key: $(uuidgen)" \
     -d '{
       "model": "tipo-text",
       "input": "Escreve uma saudação curta.",
       "max_output_tokens": 120
     }'

3. 3

   Leia output_text

   Uma resposta bem-sucedida retorna 200, uso de tokens e o custo liquidado.

   Copiar

   {
     "id": "resp_…",
     "object": "response",
     "model": "tipo-text",
     "output_text": "Olá! Como posso ajudar?",
     "usage": {
       "input_tokens": 12,
       "output_tokens": 8,
       "total_tokens": 20
     },
     "billing": {
       "mode": "live",
       "currency": "MZN",
       "charged_micro_mzn": 9400
     }
   }

4. Pronto

   Use a mesma chave de idempotência apenas para repetir a mesma operação após uma falha de rede.

   Explorar referência