---
title: "Preparar ou ajustar o plano"
description: "Descreva em linguagem natural o que deve ser traduzido, visualize as contagens reais e uma prévia da extração e refine até o plano ficar perfeito antes de usar créditos."
canonical: "https://ai-glot.com/docs/pt/api/translations/plan"
updated: "2026-08-31"
---

# Preparar ou ajustar o plano

Requer `batches:create`. O planejamento é gratuito e pode ser refeito quantas vezes forem necessárias: nada é cobrado até você [aprovar](/docs/api/translations/approve).

## Instrução ou ajuste

Envie um ou outro, nunca ambos.

| Campo         | Significado                                                                             |
| ------------- | --------------------------------------------------------------------------------------- |
| `instruction` | Planejar do zero. Substitui completamente qualquer plano anterior.                      |
| `refinement`  | Ajustar o plano existente: "na verdade, apenas as linhas vazias", "não altere as URLs". |

A distinção é importante quando o plano está quase certo: `refinement` mantém tudo o que você já definiu, enquanto `instruction` recomeça do zero e pode reinterpretar trechos que já estavam corretos.

## Revise o plano antes de aprovar

A resposta inclui o plano reconstruído com contagens **medidas** (a quantidade real de itens e palavras encontrados no arquivo, e não uma estimativa baseada no tamanho), além de uma prévia de dez extrações reais.

Essas dez amostras são a verificação mais prática e econômica disponível. Elas exibem exatamente as strings que serão enviadas para tradução, permitindo identificar antes de qualquer cobrança se uma instrução acabou selecionando o campo errado.

> **Warning: Sempre planeje primeiro**
>
> Tentar aprovar sem um plano falhará com o erro `no_plan_yet`. Isso é intencional: garante que nenhuma integração possa cobrar um workspace por uma tradução que ninguém definiu.
