Imagens assíncronas

Disponibilidade e acesso

Use uma chave com o escopo images.create. Projetos de teste geram um resultado sandbox sem custo. No ambiente live, o preço tipo-image, o interruptor de imagens e a IA precisam estar ativos.

1. Criar um job com POST

Envie uma Idempotency-Key nova e um prompt de até 4.000 caracteres. A primeira versão produz uma imagem PNG quadrada de 1024 × 1024 com qualidade baixa. model é opcional; se o enviar, use apenas tipo-image.

curl https://api.tipochat.co.mz/v1/images/generations \
  -X POST \
  -H "Authorization: Bearer $TIPOCHAT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "tipo-image",
    "prompt": "Uma ilustração de Maputo ao amanhecer, estilo editorial."
  }'

{
  "id": "",
  "object": "job",
  "type": "image_generation",
  "mode": "sandbox",
  "status": "queued"
}

2. Consultar o resultado com GET

Faça GET a cada 2 segundos com a mesma chave de projeto. Enquanto status for queued ou processing, aguarde; não repita o POST com outra chave.

curl https://api.tipochat.co.mz/v1/images/jobs/ \
  -H "Authorization: Bearer $TIPOCHAT_API_KEY"

Quando status for done, obtenha a imagem em output.image_url. O URL é temporário e expira 10 minutos depois de cada consulta; guarde o ficheiro no seu próprio armazenamento se precisar dele por mais tempo.

{
  "id": "",
  "status": "done",
  "output": {
    "format": "png",
    "size": "1024x1024",
    "image_url": "https://…"
  }
}

3. Apagar prompt e ficheiro

Quando já não precisar do job, apague os dados retidos. A chamada devolve 204; um job em processamento devolve 409 job_processing.

curl https://api.tipochat.co.mz/v1/images/jobs//data \
  -X DELETE \
  -H "Authorization: Bearer $TIPOCHAT_API_KEY"