# General Translation Platform: Traducir cadenas
URL: https://generaltranslation.com/es/docs/platform/core/guides/translating-strings.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Cómo traducir cadenas y contenido estructurado desde el código con la biblioteca generaltranslation.

Puedes usar [translate](/docs/platform/core/reference/gt-class-methods/translation/translate) y [translateMany](/docs/platform/core/reference/gt-class-methods/translation/translate-many) para traducir cadenas directamente desde el código.

Usa la traducción de cadenas cuando tu aplicación, script o servicio necesite contenido traducido en tiempo de ejecución en lugar de traducir un archivo completo.

## Antes de comenzar [#before-start]

Asegúrate de haber completado el [Quickstart](/docs/platform/core/quickstart) para instalar `generaltranslation` e inicializar la clase [GT](/docs/platform/core/reference/gt-class/constructor).

## Traduce una cadena [#translate-one-string]

Llama a [translate](/docs/platform/core/reference/gt-class-methods/translation/translate) con la cadena de origen y la configuración regional de destino.

Si tu instancia de [GT](/docs/platform/core/reference/gt-class/constructor) tiene una [targetLocale](/docs/platform/core/reference/types/gt-constructor-params), puedes omitir la configuración regional de destino en la llamada al método. Esto resulta útil cuando un script o servicio traduce muchas cadenas a la misma configuración regional.

```typescript title="src/index.ts"
const result = await gt.translate('Hello, world!', 'es');

if (result.success) {
  console.log(result.translation); // "¡Hola, mundo!"
} else {
  console.error(`Translation failed: ${result.error}`);
}
```

(Consulta el método [translate](/docs/platform/core/reference/gt-class-methods/translation/translate) para más información).

## Traducir muchas cadenas [#translate-many-strings]

Llama a [translateMany](/docs/platform/core/reference/gt-class-methods/translation/translate-many) para traducir de forma eficiente varios elementos de contenido en una sola solicitud a la API. Está optimizado para el procesamiento en lote y ofrece un mejor rendimiento que hacer varias llamadas individuales a [translate](/docs/platform/core/reference/gt-class-methods/translation/translate).

```typescript title="src/index.ts"
const results = await gt.translateMany(
  ['Hello, world!', 'Welcome to our app', 'Click here to continue'],
  'es'
);
```

(Consulta el método [translateMany](/docs/platform/core/reference/gt-class-methods/translation/translate-many) para obtener más información).

## Añade contexto con metadatos del texto fuente [#add-context-source]

Usa metadatos cuando una cadena necesite más contexto.

```typescript title="src/index.ts"
const result = await gt.translate(
  {
    source: 'Cells',
    metadata: {
      context: 'Spreadsheet column header',
    },
  },
  'es'
);
```

Los metadatos son útiles para palabras ambiguas, etiquetas de la interfaz de usuario, términos específicos del producto y cadenas que son difíciles de entender sin el contexto que las rodea.

## Next steps

- /docs/platform/core/guides/translating-files
- /docs/platform/core/guides/locale-codes

## Sitemap

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