# General Translation Platform: Tradurre contenuti in fase di esecuzione
URL: https://generaltranslation.com/it/docs/platform/openapi/reference/translation/translate-runtime.mdx
---

title: "Tradurre contenuti in fase di esecuzione"
description: "Traduci una o più stringhe o voci di contenuto strutturato con caching e memoizzazione. L'autenticazione è facoltativa; le richieste non autenticate potrebbero ricevere risultati parziali. Riferimento API per Tradurre contenuti in fase di esecuzione."
method: POST
full: true
_openapi:
  method: POST
  route: /v2/translate
  toc: []
  structuredData:
    headings: []
    contents:
      - content: >
          Traduci una o più stringhe o voci di contenuto strutturato con
          caching e memoizzazione. L'autenticazione è facoltativa; le richieste
          non autenticate potrebbero ricevere risultati parziali.
---



## `POST https://api.gtx.dev/v2/translate`

Translate one or more strings or structured content entries with caching and memoization. Authentication is optional; unauthenticated requests may receive partial results.

Authentication: send an API key as a bearer token in the `Authorization: Bearer <key>` header.

### Parameters

- `gt-api-version` (header, "2025-01-01.v0" | "2025-11-03.v1" | "2026-02-18.v1" | "2026-03-06.v1", optional): API version. Defaults to the earliest supported version. Latest is `2026-03-06.v1`.
- `gt-project-id` (header, string, optional): Target project ID. Required when authenticating with an organization API key.

### Request body

Body (`application/json`, object):
- `requests` (object, required): Map of request key to a translation request entry.
- `targetLocale` (string, required)
- `sourceLocale` (string, required)
- `metadata` (object, required)
  - `modelProvider` ("ANTHROPIC" | "OPENAI" | "XAI" | "GOOGLE")

### Responses

**200**: Cached or partially completed translation results, keyed by request key.
Response body (`application/json`, object):

**201**: Translation results, keyed by request key.
Response body (`application/json`, object):

**400**: The request was invalid.
Response body (`application/json`, object):
- `error` (string): Human-readable error message.

**402**: Payment or quota validation failed.
Response body (`application/json`, object):
- `error` (string): Human-readable error message.

**403**: The API key lacks the required permission, or the action is not allowed on the current plan.
Response body (`application/json`, object):
- `error` (string): Human-readable error message.

**429**: Rate limit or quota exceeded.
Response body (`application/json`, object):
- `error` (string): Human-readable error message.

The complete OpenAPI 3.1 spec is available at https://generaltranslation.com/openapi.yaml.