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.

Se requiere exactamente uno de los dos: source_url o upload_id.

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",
  "upload_id": null,
  "temperature": 0,
  "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",
  "upload_id": null,
  "temperature": 0,
  "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.

Crear una subida

Transcribe un archivo directamente desde una aplicación de escritorio, un complemento de edición o un servidor privado, sin alojarlo antes en ningún sitio público.

Devuelve 201 con el recurso de subida. La URL firmada es válida durante cuatro horas y está vinculada a las cabeceras de upload_headers: envíalas exactamente como se devuelven en el PUT o el almacenamiento rechazará la petición. La cabecera length-range es la que impone el límite de 4 GB.

Se respeta Idempotency-Key, así que una creación reintentada devuelve la misma subida en lugar de generar un segundo hueco.

Créditos: Gratis. Los créditos se cobran cuando la subida se envía como transcripción, a la tarifa de transcripción.

# 1. Create the upload
curl -X POST https://api.inwista.ai/v1/uploads \
  -H "Authorization: Bearer inw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "filename": "interview.m4a", "content_type": "audio/mp4" }'

# 2. PUT the file to upload_url with upload_headers
curl -X PUT "<upload_url>" \
  -H "Content-Type: audio/mp4" \
  -H "x-goog-content-length-range: 0,4294967296" \
  -H "x-goog-if-generation-match: 0" \
  --data-binary @interview.m4a

# 3. Submit it
curl -X POST https://api.inwista.ai/v1/transcriptions \
  -H "Authorization: Bearer inw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "upload_id": "7hKq2mZp…", "language": "en" }'

{
  "id": "7hKq2mZp…",
  "object": "upload",
  "status": "pending",
  "filename": "interview.m4a",
  "content_type": "audio/mp4",
  "size_bytes": 84213770,
  "transcription_id": null,
  "created": 1754558000,
  "upload_url": "https://storage.googleapis.com/…",
  "upload_method": "PUT",
  "upload_headers": {
    "Content-Type": "audio/mp4",
    "x-goog-content-length-range": "0,4294967296",
    "x-goog-if-generation-match": "0"
  },
  "upload_url_expires_at": 1754572400
}

Con el audio basta para transcribir: exportar solo la pista de audio deja un largometraje por debajo de 100 MB.

Una subida se convierte en exactamente una transcripción. Enviarla de nuevo responde 409 upload_already_used.

Consultar una subida

Comprueba si un archivo ya se ha enviado y en qué transcripción se ha convertido.

El recurso de subida sin los campos de un solo uso. status pasa a consumed y transcription_id se establece cuando la subida se ha enviado.

Créditos: Gratis.

curl https://api.inwista.ai/v1/uploads/7hKq2mZp… \
  -H "Authorization: Bearer inw_live_…"

{
  "id": "7hKq2mZp…",
  "object": "upload",
  "status": "consumed",
  "filename": "interview.m4a",
  "content_type": "audio/mp4",
  "size_bytes": 84213770,
  "transcription_id": "aB3dE9f2…",
  "created": 1754558000
}

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