---
title: "Prepara o perfeziona il piano"
description: "Descrivi in linguaggio naturale cosa tradurre, controlla i conteggi effettivi e un'anteprima reale dell'estrazione, e perfeziona il piano prima di spendere crediti."
canonical: "https://ai-glot.com/docs/it/api/translations/plan"
updated: "2026-08-31"
---

# Prepara o perfeziona il piano

Richiede `batches:create`. La pianificazione è gratuita e ripetibile: non viene addebitato nulla finché non effettui l'[approvazione](/docs/api/translations/approve).

## Istruzione o perfezionamento

Invia l'uno o l'altro, non entrambi.

| Campo         | Significato                                                                               |
| ------------- | ----------------------------------------------------------------------------------------- |
| `instruction` | Pianifica da zero. Sostituisce completamente qualsiasi piano precedente.                  |
| `refinement`  | Modifica il piano già esistente: "in realtà, solo le righe vuote", "non toccare gli URL". |

La distinzione è importante quando un piano è quasi corretto: `refinement` mantiene tutto ciò che hai già approvato, mentre `instruction` ricomincia da capo e potrebbe reinterpretare parti che andavano già bene.

## Controlla il piano prima di approvare

La risposta include il piano rigenerato con i conteggi **effettivi** (il numero reale di elementi e parole individuati nel file, non una stima basata sulle dimensioni), oltre a un'anteprima di dieci estrazioni reali.

Questi dieci elementi rappresentano la verifica più economica a disposizione. Mostrano le stringhe esatte che verranno inviate per la traduzione, così un'istruzione che ha accidentalmente selezionato il campo sbagliato risulterà visibile prima di comportare qualsiasi costo.

> **Warning: Pianifica sempre prima**
>
> L'approvazione senza un piano genera l'errore `no_plan_yet`. È una scelta intenzionale: garantisce che nessuna integrazione possa addebitare a un workspace una traduzione che nessuno ha impostato.