| lang | The ISO code(s) of the target language(s) for translation (comma-separated values). | no | fr |
| source | The ISO code of the source language for translation. Defaults to 'en' (English). | no | en |
| filename_template | Template (jinja) for the translated file names. | no | {{dirname}}/{{basename}}.{{lang}}{{extname}} |
| instructions | Additional prompting instructions that will be injected in the translation prompt. | no | — |
| instructions_file | File containing additional prompting instructions that will be injected in the translation prompt. | no | — |
| translations_dir | Directory where the translations will be stored. Defaults to 'translations'. | no | translations |
| starlight_dir | Root directory for the Astro Starlight documentation. | no | — |
| starlight_base | Base path for the Astro Starlight documentation. | no | — |
| glossary_file | A markdown file containing the glossary of the project | no | — |
| max_translation_tokens | Maximum number of tokens to process in a translation LLM call. | no | 8000 |
| max_validation_tokens | Maximum number of tokens to process in a validation LLM call. | no | 2000 |
| files | Files to process, separated by semi columns (;). .md,.mdx | no | — |
| debug | Enable debug logging (https://microsoft.github.io/genaiscript/reference/scripts/logging/). | no | — |
| model_alias | A YAML-like list of model aliases and model id: `translation: github:openai/gpt-4o` | no | — |
| openai_api_key | OpenAI API key | no | — |
| openai_api_base | OpenAI API base URL | no | — |
| azure_openai_api_endpoint | Azure OpenAI endpoint. In the Azure Portal, open your Azure OpenAI resource, Keys and Endpoints, copy Endpoint. | no | — |
| azure_openai_api_key | Azure OpenAI API key. **You do NOT need this if you are using Microsoft Entra ID. | no | — |
| azure_openai_subscription_id | Azure OpenAI subscription ID to list available deployments (Microsoft Entra only). | no | — |
| azure_openai_api_version | Azure OpenAI API version. | no | — |
| azure_openai_api_credentials | Azure OpenAI API credentials type. Leave as 'default' unless you have a special Azure setup. | no | — |
| azure_ai_inference_api_key | Azure AI Inference key | no | — |
| azure_ai_inference_api_endpoint | Azure Serverless OpenAI endpoint | no | — |
| azure_ai_inference_api_version | Azure Serverless OpenAI API version | no | — |
| azure_ai_inference_api_credentials | Azure Serverless OpenAI API credentials type | no | — |
| github_token | GitHub token with `models: read` permission at least (https://microsoft.github.io/genaiscript/reference/github-actions/#github-models-permissions). | no | — |