Traducir un CSV
Una hoja de productos mezcla cosas que nunca deberían cambiar, como códigos SKU, precios y marcas de tiempo, con cosas que siempre deberían cambiar, como una descripción o un texto de marketing. Este endpoint le permite señalar exactamente cuáles columnas son idioma y cuáles son datos, y traduce únicamente las primeras.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
El problema de traducir la hoja completa
Si pasa un CSV entero por un traductor genérico, con gusto intentará traducir un código SKU, alterará un formato de fecha o convertirá un símbolo de moneda en algo que su sistema de contabilidad no reconoce. Un catálogo de productos con una columna de título, una de descripción y una docena de columnas numéricas y categóricas necesita una traducción quirúrgica, no un pase general, que es exactamente para lo que está construido translate.csv, ya que usted especifica las columnas de destino desde el inicio.
Selección de columnas y todo lo demás
Usted envía el CSV junto con una lista de nombres o índices de columna a traducir y el idioma de destino. Las filas, el orden de las filas y cada columna que no se marcó, ids, precios, fechas, códigos de categoría, indicadores booleanos, pasan idénticos byte por byte respecto al origen. La fila de encabezado puede traducirse opcionalmente o dejarse tal cual, ya que algunos flujos dependen de los nombres de encabezado en inglés más adelante en la cadena.
Cómo corre la solicitud
Envíe por POST a /translate/csv y la tarea se pone en cola de inmediato, devolviendo un task_id mientras la traducción ocurre en segundo plano, útil para catálogos con miles de filas que de otro modo ocuparían una solicitud durante minutos. El CSV terminado, con el mismo orden de columnas y el mismo número de filas que el origen, llega mediante una llamada de webhook firmada o un enlace firmado válido por 24 horas.
Dónde se usa realmente la traducción de CSV
Las hojas de cálculo son el común denominador más bajo de los datos empresariales, exportadas de una base de datos, editadas en un programa de hojas de cálculo, reimportadas en otro lugar, lo que significa que una gran parte del trabajo real de localización ocurre en formato CSV mucho antes de que alguien lo cargue en un CMS propiamente dicho. Los feeds de productos de un mercado en línea, los archivos exportados de un CRM y las hojas de inventario destinadas a una tienda regional casi nunca son JSON limpio; son archivos CSV con columnas de idioma y columnas de lógica de negocio entrelazadas. Como el precio es por celda y no por fila ni por archivo, traducir un catálogo de 10,000 filas con dos columnas de idioma cuesta lo mismo por unidad que traducir un archivo de prueba de 10 filas con las mismas dos columnas, así que un equipo puede validar el mapeo en un puñado de filas antes de comprometer la exportación completa.
Qué puede hacer con ella
Feed de productos de un marketplace
Un vendedor traduce las columnas de título y descripción de un feed de 5,000 productos al español, dejando intactas las columnas de SKU, precio y existencias.
Localización de exportación de CRM
Un equipo de ventas traduce la columna de notas de una exportación de CRM para un equipo regional, conservando exactamente como se exportaron los IDs de contacto, fechas y códigos de etapa del embudo.
Hoja de inventario multilingüe
Un minorista con bodegas en tres países traduce únicamente la columna de nombre de producto de un CSV de inventario compartido a cada idioma local.
Revisión de respuestas de encuesta
Un equipo de investigación traduce la columna de respuestas abiertas de una exportación de encuesta para que revisores en otro país lean las respuestas sin tocar las columnas de ID de encuestado ni de puntaje.
Preguntas frecuentes
¿Cómo traduzco un archivo CSV con la API?
Envíe el CSV, los nombres o índices de columna a traducir y el idioma de destino por POST a /translate/csv, guarde el task_id devuelto y obtenga el archivo por webhook o mediante un enlace firmado válido por 24 horas.
¿Es gratis la API para traducir CSV?
No, no hay plan gratuito ni prueba; cuesta $0.003 por solicitud más $0.0135 por celda traducida, y una tarea fallida nunca se cobra.
¿Puedo elegir qué columnas se traducen?
Sí, usted especifica exactamente qué columnas traducir; cualquier otra columna, incluyendo IDs, precios y fechas, pasa sin cambios.
¿Conserva el orden de filas y de columnas?
Sí, el CSV devuelto tiene el mismo número de filas, el mismo orden de filas y el mismo orden de columnas que el archivo que usted envió.
¿Traduce la fila de encabezado?
Puede elegir traducir la fila de encabezado o dejarla tal cual, ya que algunos sistemas posteriores dependen de los nombres de encabezado originales.
¿Puedo traducir archivos CSV muy grandes?
Sí, los catálogos con miles de filas se procesan de forma asíncrona en segundo plano, y el precio por celda mantiene el costo proporcional a la cantidad real de texto traducido.
¿Ya está disponible este endpoint?
Sí, /translate/csv está disponible y aceptando solicitudes en este momento.
¿Qué pasa con mis datos CSV después de traducirlos?
Los archivos de origen y los traducidos se eliminan después del período de retención y nunca se usan para entrenamiento.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/translate/csv \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/translate/csv", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/translate/csv",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/translate/csv", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/translate/csv", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"input": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "translate.csv",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_tokens | 20000 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |