POST/v1/responses

Criar uma resposta

Cria uma resposta de texto usando o produto tipo-text.

AutenticaçãoBearer API key

Parâmetros do corpo

Parâmetro	Tipo	Obrigatório	Regra
`input`	string	Obrigatório	Texto não vazio, até 8.000 caracteres.
`instructions`	string	Opcional	Até 2.000 caracteres.
`model`	string	Opcional	Se enviado, deve ser `tipo-text`.
`max_output_tokens`	integer	Opcional	1–2.048; padrão 512.
`stream`	boolean	Opcional	`true` é recusado; streaming não existe.

POST e GET para texto

Texto é síncrono: faça POST /v1/responses e leia o resultado no próprio 200. Não existe GET /v1/responses/{id} nem polling para este recurso. Use GET https://api.tipochat.co.mz/health apenas para confirmar que o proxy responde; ele não valida chave, saldo nem disponibilidade de IA.

Se a rede falhar antes de receber a resposta, repita o mesmo POST com o mesmo corpo e a mesma Idempotency-Key. Se receber uma resposta HTTP, trate-a como definitiva; não crie uma segunda operação com outra chave.

Resposta de sucesso

Uma resposta live bem-sucedida retorna 200. A versão sandbox usa o mesmo formato com billing.mode = sandbox e custo zero.

Erros

Consulte Erros e repetição para códigos, objeto de erro e ações recomendadas.

POST/v1/responses

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
  }'

200 OK

{
  "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
  }
}