# Como forçar uma saída em JSON válido (sem markdown)

> Templates para extrair e transformar dados em JSON estrito, com regras de validação.

Fonte: Promptea — https://www.promptea.me/pt/guides/json-output · Idioma: Português · Última atualização: 2026-11-09

## Regras que funcionam

- Diga: 'Retorne SOMENTE JSON' e proíba texto extra.
- Defina um esquema (chaves, tipos, valores permitidos).
- Diga o que fazer com campos ausentes (null ou omitir).
- Peça uma segunda passada: validar + corrigir o JSON.

## Antes → depois: de 'me dê um JSON' a um contrato

- Antes: "Me dê os dados de contato deste e-mail em JSON." Resultado típico: uma frase de introdução, um bloco de código markdown e chaves que mudam de uma execução para outra.
- Depois: "Extraia os dados de contato. Retorne SOMENTE JSON válido, sem markdown. Esquema: {name: string, email: string|null, phone: string|null}. Use null para tudo o que faltar; não adivinhe."
- O que mudou: a saída é um esquema definido, com uma regra para valores ausentes e a proibição de texto extra, então o mesmo prompt entrega sempre o mesmo formato.

## Valide no código, não na esperança

- Processe a resposta com um parser de JSON de verdade e confira com o esquema (chaves obrigatórias, tipos, valores permitidos) antes de usá-la.
- Em caso de falha, tente mais uma vez anexando o erro: 'Sua saída anterior falhou na validação: [erro]. Retorne apenas o JSON corrigido.'
- Onde o modelo ou a API oferecer um modo nativo de saída estruturada, use-o: o formato passa a ser imposto na geração, em vez de pedido em prosa. As páginas de modelos do Promptea mostram quais modelos atuais o oferecem.
- JSON válido não é necessariamente conteúdo correto. Confira por amostragem os valores com o texto-fonte, principalmente números e datas.

Para conferir se um prompt de JSON nomeia os campos, os tipos e a regra do null antes de rodá-lo, use o [analisador de prompts](https://www.promptea.me/pt/analyzer).

## Templates

### Extrair JSON estruturado

```text
Extraia os dados do texto abaixo.
Retorne SOMENTE JSON válido (sem markdown, sem comentários).

Esquema:
{
  "people": [
    {
      "name": "string",
      "role": "string|null",
      "email": "string|null"
    }
  ],
  "dates": ["YYYY-MM-DD"]
}

Regras:
- Se faltar, use null (não invente).
- Se uma data for ambígua, omita.

Texto:
"""[cole aqui]"""

Antes de finalizar, valide se a saída é um JSON válido e segue o esquema.
```

[Abrir no Promptea](https://www.promptea.me/pt/analyzer?prompt=Extraia+os+dados+do+texto+abaixo.%0ARetorne+SOMENTE+JSON+v%C3%A1lido+%28sem+markdown%2C+sem+coment%C3%A1rios%29.%0A%0AEsquema%3A%0A%7B%0A++%22people%22%3A+%5B%0A++++%7B%0A++++++%22name%22%3A+%22string%22%2C%0A++++++%22role%22%3A+%22string%7Cnull%22%2C%0A++++++%22email%22%3A+%22string%7Cnull%22%0A++++%7D%0A++%5D%2C%0A++%22dates%22%3A+%5B%22YYYY-MM-DD%22%5D%0A%7D%0A%0ARegras%3A%0A-+Se+faltar%2C+use+null+%28n%C3%A3o+invente%29.%0A-+Se+uma+data+for+amb%C3%ADgua%2C+omita.%0A%0ATexto%3A%0A%22%22%22%5Bcole+aqui%5D%22%22%22%0A%0AAntes+de+finalizar%2C+valide+se+a+sa%C3%ADda+%C3%A9+um+JSON+v%C3%A1lido+e+segue+o+esquema.&purpose=data&target=gpt)

### Transformar JSON para um novo esquema

```text
Você vai receber um JSON de entrada. Converta-o para o esquema de saída.
Retorne SOMENTE JSON válido.

JSON de entrada:
"""[cole o JSON]"""

Esquema de saída:
{
  "items": [
    { "id": "string", "title": "string", "tags": ["string"] }
  ]
}

Regras:
- Preserve o sentido; não invente itens novos.
- Se um campo de entrada não tiver correspondência, ignore.
- Garanta que as tags fiquem em minúsculas.

Valide o JSON antes de retornar.
```

[Abrir no Promptea](https://www.promptea.me/pt/analyzer?prompt=Voc%C3%AA+vai+receber+um+JSON+de+entrada.+Converta-o+para+o+esquema+de+sa%C3%ADda.%0ARetorne+SOMENTE+JSON+v%C3%A1lido.%0A%0AJSON+de+entrada%3A%0A%22%22%22%5Bcole+o+JSON%5D%22%22%22%0A%0AEsquema+de+sa%C3%ADda%3A%0A%7B%0A++%22items%22%3A+%5B%0A++++%7B+%22id%22%3A+%22string%22%2C+%22title%22%3A+%22string%22%2C+%22tags%22%3A+%5B%22string%22%5D+%7D%0A++%5D%0A%7D%0A%0ARegras%3A%0A-+Preserve+o+sentido%3B+n%C3%A3o+invente+itens+novos.%0A-+Se+um+campo+de+entrada+n%C3%A3o+tiver+correspond%C3%AAncia%2C+ignore.%0A-+Garanta+que+as+tags+fiquem+em+min%C3%BAsculas.%0A%0AValide+o+JSON+antes+de+retornar.&purpose=data&target=gemini)

## Perguntas frequentes

### Por que o modelo ainda coloca texto?

Porque você não deixou isso custoso. Repita a restrição, forneça um esquema e peça validação.

### Devo usar JSON Schema?

Sim, em integrações estritas. Até um esquema simplificado (chaves + tipos) ajuda bastante.

### O que o modelo deve retornar quando falta um valor?

Escolha uma regra e declare: null para o valor ausente ou omitir a chave. Misturar as duas obriga o seu código a tratar ambas. Diga também para não adivinhar.

### Posso pedir JSON e uma explicação na mesma resposta?

Mantenha os dois separados: coloque a explicação em uma chave própria, como "notes", ou faça um segundo pedido. Texto fora do JSON quebra o parse.
