API del traductor de Creator Tools: guía para desarrolladores

Esta guía explica cómo traducir videos y canales de YouTube con el traductor de Creator Tools desde tu propio código. ¿Es tu primera vez con la API? Empieza por la presentación: El traductor de Creator Tools ya está disponible por API.

Resumen

• La traducción se ejecuta como una tarea en segundo plano. Inicias una tarea, recibes un jobId y consultas la tarea hasta que termine.
• Iniciar una tarea y consultarla usan la misma dirección: POST https://api.creator-tools.com/info/longterm-job. El campo requestType del cuerpo indica qué operación quieres.
• Cuando la tarea termina, el título, la descripción y los subtítulos traducidos ya están publicados en YouTube.
• No hay callbacks. Consulta el estado de la tarea cada 5 segundos, igual que hace la aplicación de Creator Tools.

1. POST /info/longterm-job  { "requestType": "startTranslationJob", … }  →  { "jobId": "…", "status": "IN_PROGRESS" }
2. POST /info/longterm-job  { "requestType": "getJobById", "jobId": "…" }  →  { "status": "IN_PROGRESS" }
   … espera 5 segundos y repite …
3. POST /info/longterm-job  { "requestType": "getJobById", "jobId": "…" }  →  { "status": "FINISHED", "response": { … } }

Claves que necesitas

Cada solicitud necesita cuatro valores. La clave de la pasarela te la da una sola vez el equipo de soporte. Los otros tres los copias desde el navegador mientras tienes la sesión iniciada en https://app.creator-tools.com; el siguiente capítulo muestra dónde están.

Todas las solicitudes son POST con Content-Type: application/json. No hacen falta cookies ni la cabecera Authorization.

Cómo encontrar tu ID de sesión y tu ID de canal

Paso 1: inicia sesión y elige el canal

Abre https://app.creator-tools.com, inicia sesión y selecciona en la lista de canales el canal que quieres traducir. Si el canal aún no aparece, añádelo primero con Add channel (añadir canal).

Paso 2: abre el almacenamiento local

Abre las herramientas para desarrolladores (F12 en Windows, ⌥⌘I en Mac) → Application → Local storage → https://app.creator-tools.com → clave channels.

El valor tiene una entrada por cada canal conectado. El nombre de la entrada es el ID del canal, y la entrada contiene el ID de sesión:

{
  "UCzOmbH8UyFIVjSAukXAhY5g": {            // ← channelId
    "sessionId": "f35876a8-1…",            // ← sessionId
    "channelId": "UCzOmbH8UyFIVjSAukXAhY5g",
    "name": "My Channel",
    "isSelected": true                      // ← el canal elegido en la aplicación
  },
  "UC…another channel…": { … }
}

Si tienes varios canales, usa la entrada con "isSelected": true, o aquella cuyo name coincida con el canal que quieres.

Conviene saber

• El ID del canal es el ID de canal de YouTube que empieza por UC. El ID de sesión lo crea Creator Tools cuando conectas el canal.
• La conexión de un canal dura unos tres meses. Si recibes 403 No credentials for channel, elimina el canal en la aplicación, vuelve a añadirlo y copia el nuevo ID de sesión.
• Cerrar sesión en la aplicación termina la sesión, así que el ID de sesión anterior deja de funcionar.

Iniciar una traducción

POST https://api.creator-tools.com/info/longterm-job

Cabeceras: Content-Type: application/json y x-api-key: <gateway key>.

Qué se traduce

• Con videoId: el título y la descripción del video, y también los subtítulos si capturesIncluded es true.
• Sin videoId: el nombre y la descripción del canal.

Campos de la solicitud

Ejemplo: un video con subtítulos

curl -X POST https://api.creator-tools.com/info/longterm-job \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: <GATEWAY_KEY>' \
  -d '{
    "xApiKey": "<PERSONAL_KEY>",
    "requestType": "startTranslationJob",
    "sessionId": "<SESSION_ID>",
    "channelId": "UCxxxxxxxxxxxxxxxxxxxxxx",
    "videoId": "dQw4w9WgXcQ",
    "languages": ["es", "de", "fr", "pt-BR", "ja"],
    "capturesIncluded": true,
    "rewrite": false,
    "saveHashtags": true,
    "excludedFromTranslate": false,
    "useDialects": false,
    "tone": "default",
    "provider": "openai",
    "isPoetry": false,
    "aiTranslations": true
  }'

Respuesta

Una respuesta 200 describe la nueva tarea. Guarda el jobId: lo necesitas para consultar la tarea.

{
  "jobId": "3f1c2a0e-7b8d-4c1e-9a55-…",
  "jobType": "translate",
  "videoId": "dQw4w9WgXcQ",
  "channelId": "UCxxxxxxxxxxxxxxxxxxxxxx",
  "status": "IN_PROGRESS",
  "languages": ["es", "de", "fr", "pt-BR", "ja"],
  "startDate": "2026-09-30T10:15:00.000Z"
}

Consultar el estado de la tarea

POST https://api.creator-tools.com/info/longterm-job, con las mismas cabeceras que antes.

{
  "xApiKey": "<PERSONAL_KEY>",
  "requestType": "getJobById",
  "jobId": "3f1c2a0e-7b8d-4c1e-9a55-…"
}

La respuesta 200 es la tarea, o null si no tienes ninguna tarea con ese ID.

{
  "jobId": "3f1c2a0e-…",
  "jobType": "translate",
  "status": "FINISHED",
  "startDate": "2026-09-30T10:15:00.000Z",
  "finishDate": "2026-09-30T10:16:12.000Z",
  "languages": ["es", "de", "fr", "pt-BR", "ja"],
  "languagesToTranslateVideo": ["es", "de", "fr", "pt-BR", "ja"],
  "languagesToTranslateCaptions": ["es", "de", "fr", "pt-BR", "ja"],
  "response": {
    "status": "translated",
    "captionsTranslated": true,
    "metadataLanguagesTranslated": 5,
    "captionsLanguageTranslated": 5
  }
}

Valores de estado

• Con qué frecuencia consultar: cada 5 segundos. La aplicación deja de esperar a los 50 minutos.
• Sin porcentaje de progreso: las tareas de traducción solo informan de su estado.
• Todas tus tareas: envía "requestType": "getAllJobs" con tu xApiKey para listar todas las tareas.
• Cuánto tiempo se guardan las tareas: una tarea terminada se puede leer durante 60 días.

Errores

Una respuesta de error tiene la forma {"message": "…"}.

Ejemplo completo en JavaScript

const API = "https://api.creator-tools.com/info/longterm-job";
const GATEWAY_KEY = "<GATEWAY_KEY>";
const xApiKey = "<PERSONAL_KEY>";
const sessionId = "<SESSION_ID>";
const channelId = "UC…";

// Inicia una tarea. Inicia el siguiente video solo cuando esta termine en FINISHED o FAILED.
const job = await post({
  xApiKey, requestType: "startTranslationJob", sessionId, channelId,
  videoId: "dQw4w9WgXcQ", languages: ["es", "de", "fr"], capturesIncluded: true,
});

// Consulta cada 5 segundos hasta que la tarea termine.
let status;
do {
  await new Promise((resolve) => setTimeout(resolve, 5000));
  status = await post({ xApiKey, requestType: "getJobById", jobId: job.jobId });
} while (status && status.status !== "FINISHED" && status.status !== "FAILED");

console.log(status.status, status.response ?? status.reason);

async function post(body) {
  const res = await fetch(API, {
    method: "POST",
    headers: { "Content-Type": "application/json", "x-api-key": GATEWAY_KEY },
    body: JSON.stringify(body),
  });
  if (!res.ok) throw new Error((await res.json()).message);
  return res.json();
}

Idiomas y códigos

• Envía los códigos en languages exactamente como aparecen abajo. Siguen los códigos de YouTube, así que el hebreo es iw, el español de Latinoamérica es es-419 y el cantonés es yue.
• Canal significa que el código también se puede usar para traducir un canal (una solicitud sin videoId). Los demás códigos se omiten en los canales. La lista de canales también acepta en-UK, fil y nb.