Referencia de la API

Crear una transcripción

Convierte cualquier archivo multimedia alojado en subtítulos precisos y con marcas de tiempo sin que nadie abra el estudio — alimenta directamente tu CMS, tu archivo o tu canalización de publicación.

La duración del archivo se comprueba antes de aceptar la petición; el cargo al monedero y el encolado del trabajo ocurren en un único paso atómico. Devuelve 201 con el recurso de transcripción.

Créditos: 4 créditos por cada minuto iniciado de contenido multimedia, cobrados al aceptar el trabajo. Los trabajos fallidos se reembolsan automáticamente.

curl -X POST https://api.inwista.ai/v1/transcriptions \
  -H "Authorization: Bearer inw_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://cdn.example.com/interview.mp4",
    "language": "en",
    "diarization": true
  }'

{
  "id": "aB3dE9f2…",
  "object": "transcription",
  "status": "processing",
  "progress": 50,
  "language": "en",
  "duration_seconds": 1834,
  "diarization": true,
  "store_media": true,
  "retention": "standard",
  "source_url": "https://cdn.example.com/interview.mp4",
  "metadata": { "internal_ref": "case-42" },
  "credits_charged": 124,
  "error": null,
  "created": 1754558000
}

Listar transcripciones

Concilia tu catálogo con los trabajos procesados o construye un panel sobre todo lo que has transcrito.

Transcripciones creadas por API, las más recientes primero. Paginación estándar.

Créditos: Gratis.

curl "https://api.inwista.ai/v1/transcriptions?limit=10" \
  -H "Authorization: Bearer inw_live_…"

Recuperar una transcripción

Sondeo de progreso y resultado final en uno: observa cómo el estado pasa a completed y lee después la duración, el idioma y el cargo en la misma respuesta.

Sondea hasta que el estado sea completed (o registra un webhook, más abajo). Leer una transcripción fallida también activa su reembolso automático.

Créditos: Gratis.

curl https://api.inwista.ai/v1/transcriptions/aB3dE9f2… \
  -H "Authorization: Bearer inw_live_…"

{
  "id": "aB3dE9f2…",
  "object": "transcription",
  "status": "processing",
  "progress": 50,
  "language": "en",
  "duration_seconds": 1834,
  "diarization": true,
  "store_media": true,
  "retention": "standard",
  "source_url": "https://cdn.example.com/interview.mp4",
  "metadata": { "internal_ref": "case-42" },
  "credits_charged": 124,
  "error": null,
  "created": 1754558000
}

Eliminar una transcripción

Elimine un trabajo bajo demanda — control total de sus datos en una sola llamada.

Elimina la transcripción de forma permanente junto con todo lo almacenado: archivos multimedia, contenido de la transcripción, revisiones, traducciones y comentarios. Los contadores de facturación agregados se conservan — no contienen contenido.

Solo se pueden eliminar trabajos completados o fallidos; un trabajo aún en proceso devuelve 409, igual que uno con una mejora o traducción en curso. La eliminación es inmediata e irreversible.

Créditos: endpoints.delete-transcription.pricing

curl -X DELETE https://api.inwista.ai/v1/transcriptions/aB3dE9f2… \
  -H "Authorization: Bearer inw_live_…"

{
  "id": "aB3dE9f2…",
  "object": "transcription",
  "deleted": true
}

Recuperar subtítulos

Lleva archivos de subtítulos listos para emisión directamente a tu reproductor, tu MAM o tu canalización de entrega — sin exportaciones manuales ni conversiones de formato por tu parte. En una canalización de producción de video, el SRT o VTT terminado cae directamente en tu NLE, tu herramienta de revisión o tu paso de empaquetado en cuanto se transcribe un montaje.

Devuelve el cuerpo del archivo de subtítulos en bruto con el Content-Type correspondiente — sin envolver en JSON. Responde 409 not_ready hasta que la transcripción se completa.

Créditos: Gratis.

curl "https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/captions?format=srt" \
  -H "Authorization: Bearer inw_live_…" -o interview.srt

El formato json es un contrato versionado: { version: 1, language, segments: [{ index, start, end, text, speaker? }] } — segundos con precisión de milisegundos, y dentro de una versión los campos solo se añaden, nunca se eliminan.

Las traducciones pertenecen a la versión para la que se crearon — el revision_id del recurso de traducción la identifica, y la versión de una mejora posterior no las hereda. Pasa ese revision_id como revision para obtener la versión traducida.

Iniciar una mejora

Sincronización y equilibrado de líneas con calidad de emisión en piloto automático — entrega subtítulos que pasan el control de calidad sin que un editor los toque. Para productoras, esto automatiza el paso de conformado de subtítulos de la canalización de entrega: cada episodio sale con subtítulos consistentes y conformes a la especificación.

Devuelve 202 con el recurso de mejora.

Créditos: Se calcula a partir del tamaño del contenido de los subtítulos, a la misma tarifa que cobra el estudio, y se descuenta al aceptar el trabajo. Se reembolsa automáticamente en caso de fallo.

curl -X POST https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/enhance \
  -H "Authorization: Bearer inw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "settings": { "maxCharactersPerLine": 37, "textCondensation": "smart" } }'

{
  "id": "rev8Xk3…",
  "object": "enhancement",
  "transcription_id": "aB3dE9f2…",
  "status": "processing",
  "progress": 0,
  "credits_charged": 12,
  "error": null,
  "created": 1754559000
}

Recuperar una mejora

Sondeo y resultado en uno: cuando el estado indica completed, el endpoint de subtítulos ya sirve la versión mejorada.

Sondea hasta completed. Leer una mejora fallida activa su reembolso automático.

Créditos: Gratis.

curl https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/enhancements/rev8Xk3… \
  -H "Authorization: Bearer inw_live_…"

Iniciar una traducción

Una llamada por idioma convierte una pista de subtítulos terminada en una versión localizada con la misma sincronización — multiplica el alcance de cada video que ya tienes.

Devuelve 202. Responde 409 translation_exists si ese idioma ya existe para la versión actual.

Créditos: Se calcula a partir del tamaño del contenido de los subtítulos, a la misma tarifa que cobra el estudio, por idioma de destino, y se descuenta al aceptar. Se reembolsa automáticamente en caso de fallo.

curl -X POST https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/translate \
  -H "Authorization: Bearer inw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "target_language": "es" }'

{
  "id": "es",
  "object": "translation",
  "transcription_id": "aB3dE9f2…",
  "target_language": "es",
  "revision_id": "TRkf2nY7…",
  "status": "processing",
  "progress": 0,
  "credits_charged": 6,
  "error": null,
  "created": 1754559600
}

Recuperar una traducción

Sondeo y resultado en uno: una vez completed, obtén el archivo de subtítulos traducido desde el endpoint de subtítulos con el parámetro language.

Sondea hasta completed y obtén después los subtítulos traducidos desde el endpoint de subtítulos con el parámetro de consulta language.

Créditos: Gratis.

# Poll the translation resource
curl https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/translations/es \
  -H "Authorization: Bearer inw_live_…"

# Once completed, fetch the translated subtitle file
curl "https://api.inwista.ai/v1/transcriptions/aB3dE9f2…/captions?format=vtt&language=es" \
  -H "Authorization: Bearer inw_live_…" -o interview-es.vtt