# General Translation React SDKs (gt-react, gt-next, gt-react-native): tx
URL: https://generaltranslation.com/es/docs/react/nextjs/reference/functions/tx.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Traduce cadenas en tiempo de solicitud en código de servidor del App Router de Next.js con General Translation. Referencia de la API de tx.

La función `tx` traduce una cadena en tiempo de solicitud mediante la API de General Translation. Úsala para contenido dinámico que no se conoce en tiempo de compilación; usa [`getGT`](/docs/react/nextjs/reference/functions/get-gt) para cadenas de origen estáticas.

`tx` es solo para servidor y no funciona con el Pages Router.

## Resumen general [#overview]

```tsx
import { tx } from 'gt-next/server';

const translated = await tx('A message loaded at request time');
```

## Parámetros [#parameters]

| Parámetro | Descripción                                                                                            | Type     | Opcional | Predeterminado |
| --------- | ------------------------------------------------------------------------------------------------------ | -------- | -------- | -------------- |
| `message` | Cadena que se va a traducir.                                                                           | `string` | No       | —              |
| `options` | Configuración regional de destino, contexto, formato, límite de longitud y variables de interpolación. | `object` | Sí       | `{}`           |

`options` acepta `$locale`, `$context`, `$maxChars` y `$format`. Pasa las variables de interpolación como claves de nivel superior. `$maxChars` solicita al servicio de traducción una longitud máxima expresada como un entero positivo y, si es necesario, trunca la cadena devuelta a esa longitud.

## Devuelve [#returns]

**Tipo** `Promise<string>`

Una promesa que se resuelve con la cadena traducida o, cuando la traducción está deshabilitada o no es necesaria, con la cadena fuente.

## Ejemplo [#example]

```tsx title="app/notes/[id]/page.tsx"
import { tx } from 'gt-next/server';

export default async function NotePage({ params }) {
  const note = await loadNote((await params).id);
  const translated = await tx(note, {
    $context: 'A user-created note',
  });
  return <p>{translated}</p>;
}
```

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.