Referencia de opciones

Las opciones de extracción se envían en un único JSON. Usa esta página para lectura humana y GET /options/{sourceFileType} para valores legibles por máquina.

{
  "extraction": {
    "selectedCapabilities": [
      "video.audio",
      "video.metadata",
      "media.transcript"
    ],
    "includeManifest": true,
    "capabilityOptions": {
      "video.audio": {
        "audioFormat": "mp3"
      },
      "media.transcript": {
        "transcription.mode": "quality"
      }
    }
  }
}

Campos principales

Campo	Tipo	Predeterminada	Notas
`extraction.selectedCapabilities`	array de cadenas	Valores predeterminados del formato	IDs de capacidades que se incluirán en el ZIP de salida.
`extraction.includeManifest`	booleano	`true`	Incluye un resumen de archivos con la lista de archivos generados en el ZIP.
`extraction.capabilityOptions`	objeto	`{}`	Mapa de ID de capacidad a los campos de opción correspondientes.

Referencia de capacidades

Capacidad	Descripción	Usada por	Opciones
`archive.images`	Imágenes encontradas dentro del archivo comprimido.	ZIP	Ninguna
`archive.metadata`	Estructura del archivo comprimido y metadatos de archivos.	ZIP	Ninguna
`audio.artwork`	Carátulas e imágenes adjuntas.	AAC, AIF, AIFF, FLAC, M4A, M4B, MKA, MP3, OGG, OPUS, WAV, WMA	Ninguna
`audio.chapterAudio`	Audio por capítulos dividido desde marcadores.	AAC, AIF, AIFF, FLAC, M4A, M4B, MKA, MP3, OGG, OPUS, WAV, WMA	`audioFormat`
`audio.chapters`	Marcadores de capítulos exportados para revisión.	AAC, AIF, AIFF, FLAC, M4A, M4B, MKA, MP3, OGG, OPUS, WAV, WMA	Ninguna
`audio.metadata`	Información del archivo, duración, fechas y etiquetas integradas.	AAC, AIF, AIFF, FLAC, M4A, M4B, MKA, MP3, OGG, OPUS, WAV, WMA	Ninguna
`email.embeddedFiles`	Adjuntos del correo guardados como archivos separados.	EML	Ninguna
`email.images`	Imágenes integradas del correo guardadas por separado.	EML	Ninguna
`email.metadata`	Encabezados del mensaje y metadatos del correo.	EML	Ninguna
`excel.audio`	Archivos de audio extraídos cuando estén presentes.	XLSM, XLSX, XLTM, XLTX	`audioFormat`
`excel.embeddedFiles`	Archivos incrustados recuperados como archivos separados.	XLSM, XLSX, XLTM, XLTX	Ninguna
`excel.images`	Imágenes originales guardadas como archivos separados.	XLSM, XLSX, XLTM, XLTX	Ninguna
`excel.video`	Archivos de video extraídos cuando estén presentes.	XLSM, XLSX, XLTM, XLTX	Ninguna
`excel.worksheets`	CSV de hojas de cálculo para análisis o migración.	XLSM, XLSX, XLTM, XLTX	Ninguna
`executable.icons`	Recursos de iconos de Windows guardados como archivos ICO y PNG.	EXE	Ninguna
`image.codes`	Códigos QR y de barras encontrados en el archivo.	AVIF, AVIFS, BMP, GIF, HEIC, HEIF, HIF, ICO, JPEG, JPG, PNG, TIF, TIFF, WEBP	Ninguna
`image.colors`	Colores dominantes e información de paleta.	AVIF, AVIFS, BMP, GIF, HEIC, HEIF, HIF, ICO, JPEG, JPG, PNG, TIF, TIFF, WEBP	Ninguna
`image.exif`	Metadatos de estilo EXIF exportados como JSON y CSV.	AVIF, AVIFS, BMP, GIF, HEIC, HEIF, HIF, ICO, JPEG, JPG, PNG, TIF, TIFF, WEBP	Ninguna
`image.frames`	Extrae fotogramas y datos de tiempo cuando estén presentes.	AVIF, AVIFS, GIF, WEBP	`frameIntervalSeconds`, `frameMode`, `maxExtractedFrames`
`image.gps`	Coordenadas GPS y un mapa descargable cuando estén en el archivo origen.	AVIF, AVIFS, BMP, GIF, HEIC, HEIF, HIF, ICO, JPEG, JPG, PNG, TIF, TIFF, WEBP	Ninguna
`image.icons`	Tamaños de iconos e imágenes de iconos integradas.	ICO	Ninguna
`image.profiles`	Perfiles ICC y datos de gestión de color.	AVIF, AVIFS, BMP, GIF, HEIC, HEIF, HIF, ICO, JPEG, JPG, PNG, TIF, TIFF, WEBP	Ninguna
`image.text`	Texto reconocido en capturas, fotos e imágenes escaneadas con Fast AI OCR.	AVIF, AVIFS, BMP, GIF, HEIC, HEIF, HIF, ICO, JPEG, JPG, PNG, TIF, TIFF, WEBP	Ninguna
`media.transcript`	Genera texto a partir del habla.	AVI, M4V, MKV, MOV, MP4, WEBM, AAC, AIF, AIFF, FLAC, M4A, M4B, MKA, MP3, OGG, OPUS, WAV, WMA	`transcription.mode`
`pdf.annotations`	Comentarios y marcas del PDF cuando estén presentes.	PDF	Ninguna
`pdf.embeddedFiles`	Archivos incrustados en el PDF guardados por separado.	PDF	Ninguna
`pdf.fonts`	Fuentes incrustadas del PDF cuando estén presentes.	PDF	Ninguna
`pdf.forms`	Datos de campos de formulario del PDF cuando estén disponibles.	PDF	Ninguna
`pdf.images`	Imágenes incrustadas en el PDF guardadas por separado.	PDF	Ninguna
`pdf.links`	Anotaciones de enlaces del PDF para revisión.	PDF	Ninguna
`pdf.markdown`	Markdown generado desde texto de PDF.	PDF	Ninguna
`pdf.metadata`	Metadatos del documento PDF para auditoría.	PDF	Ninguna
`pdf.pages`	Páginas completas del PDF renderizadas como imágenes.	PDF	Ninguna
`pdf.text`	Texto seleccionable del PDF guardado por página.	PDF	Ninguna
`powerpoint.audio`	Archivos de audio extraídos cuando estén presentes.	POTM, POTX, PPSM, PPSX, PPTM, PPTX	`audioFormat`
`powerpoint.embeddedFiles`	Archivos incrustados recuperados como archivos separados.	POTM, POTX, PPSM, PPSX, PPTM, PPTX	Ninguna
`powerpoint.images`	Imágenes originales guardadas como archivos separados.	POTM, POTX, PPSM, PPSX, PPTM, PPTX	Ninguna
`powerpoint.markdown`	Markdown generado desde texto de diapositivas y notas del orador.	POTM, POTX, PPSM, PPSX, PPTM, PPTX	Ninguna
`powerpoint.notes`	Notas del orador divididas en archivos legibles.	POTM, POTX, PPSM, PPSX, PPTM, PPTX	Ninguna
`powerpoint.slides`	Diapositivas renderizadas para vista previa y revisión.	POTM, POTX, PPSM, PPSX, PPTM, PPTX	Ninguna
`powerpoint.text`	Texto legible para revisión, migración o búsqueda.	POTM, POTX, PPSM, PPSX, PPTM, PPTX	Ninguna
`powerpoint.video`	Archivos de video extraídos cuando estén presentes.	POTM, POTX, PPSM, PPSX, PPTM, PPTX	Ninguna
`video.audio`	Archivos de audio extraídos cuando estén presentes.	AVI, M4V, MKV, MOV, MP4, WEBM	`audioFormat`
`video.frames`	Extrae fotogramas y datos de tiempo cuando estén presentes.	AVI, M4V, MKV, MOV, MP4, WEBM	`frameIntervalSeconds`, `frameMode`, `maxExtractedFrames`
`video.metadata`	Información del archivo, dimensiones, fechas y etiquetas integradas.	AVI, M4V, MKV, MOV, MP4, WEBM	Ninguna
`video.subtitles`	Subtítulos extraídos desde pistas incrustadas.	AVI, M4V, MKV, MOV, MP4, WEBM	Ninguna
`word.audio`	Archivos de audio extraídos cuando estén presentes.	DOCM, DOCX, DOTM, DOTX	`audioFormat`
`word.embeddedFiles`	Archivos incrustados recuperados como archivos separados.	DOCM, DOCX, DOTM, DOTX	Ninguna
`word.images`	Imágenes originales guardadas como archivos separados.	DOCM, DOCX, DOTM, DOTX	Ninguna
`word.markdown`	Markdown que conserva texto, encabezados, enlaces y tablas del documento.	DOCM, DOCX, DOTM, DOTX	Ninguna
`word.pages`	Páginas listas para revisar sin abrir el documento.	DOC, DOCM, DOCX, DOT, DOTM, DOTX	Ninguna
`word.text`	Texto legible para revisión, migración o búsqueda.	DOCM, DOCX, DOTM, DOTX	Ninguna
`word.video`	Archivos de video extraídos cuando estén presentes.	DOCM, DOCX, DOTM, DOTX	Ninguna

audioFormat

Elige el formato de audio al extraer una pista de video o dividir audio desde medios incrustados.

Propiedad	Valor
Tipo	`enum`
Predeterminada	`mp3`
Valores permitidos	`mp3`, `wav`, `m4a`, `original`, `best`
Límites	Ninguna
Usada por	`audio.chapterAudio`, `excel.audio`, `powerpoint.audio`, `video.audio`, `word.audio`

Ejemplo:

{
  "extraction": {
    "capabilityOptions": {
      "video.audio": {
        "audioFormat": "mp3"
      }
    }
  }
}

frameIntervalSeconds

Define el intervalo cuando frameMode es every-n-seconds.

Propiedad	Valor
Tipo	`number`
Predeterminada	`1`
Valores permitidos	Cualquier valor dentro de los límites
Límites	0.1 a 300
Usada por	`image.frames`, `video.frames`

Ejemplo:

{
  "extraction": {
    "selectedCapabilities": [
      "video.frames"
    ],
    "capabilityOptions": {
      "video.frames": {
        "frameMode": "every-n-seconds",
        "frameIntervalSeconds": 5,
        "maxExtractedFrames": 100
      }
    }
  }
}

frameMode

Elige cómo se seleccionan los fotogramas en videos e imágenes animadas.

Propiedad	Valor
Tipo	`enum`
Predeterminada	`evenly-spaced`
Valores permitidos	`evenly-spaced`, `first`, `every-n-seconds`
Límites	Ninguna
Usada por	`image.frames`, `video.frames`

Ejemplo:

{
  "extraction": {
    "selectedCapabilities": [
      "video.frames"
    ],
    "capabilityOptions": {
      "video.frames": {
        "frameMode": "every-n-seconds",
        "frameIntervalSeconds": 5,
        "maxExtractedFrames": 100
      }
    }
  }
}

maxExtractedFrames

Limita el número de imágenes de fotogramas escritas en el ZIP.

Propiedad	Valor
Tipo	`integer`
Predeterminada	`500`
Valores permitidos	Cualquier valor dentro de los límites
Límites	1 a 2000
Usada por	`image.frames`, `video.frames`

Ejemplo:

{
  "extraction": {
    "selectedCapabilities": [
      "video.frames"
    ],
    "capabilityOptions": {
      "video.frames": {
        "frameMode": "every-n-seconds",
        "frameIntervalSeconds": 5,
        "maxExtractedFrames": 100
      }
    }
  }
}

transcription.mode

Elige el modo de transcripción para audio y video. Al seleccionar media.transcript, se generan automáticamente archivos de transcripción TXT, PDF, DOCX, MD, EPUB, SRT y VTT; la API no ofrece selectores por formato para trabajos de /extract.

Propiedad	Valor
Tipo	`enum`
Predeterminada	`fast`
Valores permitidos	`fast`, `quality`, `meeting-intelligence`
Límites	Ninguna
Usada por	`media.transcript`

Ejemplo:

{
  "extraction": {
    "selectedCapabilities": [
      "media.transcript"
    ],
    "capabilityOptions": {
      "media.transcript": {
        "transcription.mode": "quality"
      }
    }
  }
}

Matriz de tipos origen

Origen	Formato	Capacidades	Opciones de capacidad
DOC	`doc`	`word.pages`	Ninguna
DOCM	`docm`	`word.images`, `word.pages`, `word.text`, `word.markdown`, `word.audio`, `word.video`, `word.embeddedFiles`	`audioFormat`
DOCX	`docx`	`word.images`, `word.pages`, `word.text`, `word.markdown`, `word.audio`, `word.video`, `word.embeddedFiles`	`audioFormat`
DOT	`dot`	`word.pages`	Ninguna
DOTM	`dotm`	`word.images`, `word.pages`, `word.text`, `word.markdown`, `word.audio`, `word.video`, `word.embeddedFiles`	`audioFormat`
DOTX	`dotx`	`word.images`, `word.pages`, `word.text`, `word.markdown`, `word.audio`, `word.video`, `word.embeddedFiles`	`audioFormat`
PDF	`pdf`	`pdf.images`, `pdf.pages`, `pdf.text`, `pdf.markdown`, `pdf.embeddedFiles`, `pdf.metadata`, `pdf.links`, `pdf.annotations`, `pdf.forms`, `pdf.fonts`	Ninguna
POTM	`potm`	`powerpoint.images`, `powerpoint.slides`, `powerpoint.text`, `powerpoint.markdown`, `powerpoint.notes`, `powerpoint.audio`, `powerpoint.video`, `powerpoint.embeddedFiles`	`audioFormat`
POTX	`potx`	`powerpoint.images`, `powerpoint.slides`, `powerpoint.text`, `powerpoint.markdown`, `powerpoint.notes`, `powerpoint.audio`, `powerpoint.video`, `powerpoint.embeddedFiles`	`audioFormat`
PPSM	`ppsm`	`powerpoint.images`, `powerpoint.slides`, `powerpoint.text`, `powerpoint.markdown`, `powerpoint.notes`, `powerpoint.audio`, `powerpoint.video`, `powerpoint.embeddedFiles`	`audioFormat`
PPSX	`ppsx`	`powerpoint.images`, `powerpoint.slides`, `powerpoint.text`, `powerpoint.markdown`, `powerpoint.notes`, `powerpoint.audio`, `powerpoint.video`, `powerpoint.embeddedFiles`	`audioFormat`
PPTM	`pptm`	`powerpoint.images`, `powerpoint.slides`, `powerpoint.text`, `powerpoint.markdown`, `powerpoint.notes`, `powerpoint.audio`, `powerpoint.video`, `powerpoint.embeddedFiles`	`audioFormat`
PPTX	`pptx`	`powerpoint.images`, `powerpoint.slides`, `powerpoint.text`, `powerpoint.markdown`, `powerpoint.notes`, `powerpoint.audio`, `powerpoint.video`, `powerpoint.embeddedFiles`	`audioFormat`
XLSM	`xlsm`	`excel.images`, `excel.worksheets`, `excel.audio`, `excel.video`, `excel.embeddedFiles`	`audioFormat`
XLSX	`xlsx`	`excel.images`, `excel.worksheets`, `excel.audio`, `excel.video`, `excel.embeddedFiles`	`audioFormat`
XLTM	`xltm`	`excel.images`, `excel.worksheets`, `excel.audio`, `excel.video`, `excel.embeddedFiles`	`audioFormat`
XLTX	`xltx`	`excel.images`, `excel.worksheets`, `excel.audio`, `excel.video`, `excel.embeddedFiles`	`audioFormat`
AVIF	`avif`	`image.exif`, `image.gps`, `image.codes`, `image.colors`, `image.profiles`, `image.text`, `image.frames`	`frameMode`, `frameIntervalSeconds`, `maxExtractedFrames`
AVIFS	`avifs`	`image.exif`, `image.gps`, `image.codes`, `image.colors`, `image.profiles`, `image.text`, `image.frames`	`frameMode`, `frameIntervalSeconds`, `maxExtractedFrames`
BMP	`bmp`	`image.exif`, `image.gps`, `image.codes`, `image.colors`, `image.profiles`, `image.text`	Ninguna
GIF	`gif`	`image.exif`, `image.gps`, `image.codes`, `image.colors`, `image.profiles`, `image.text`, `image.frames`	`frameMode`, `frameIntervalSeconds`, `maxExtractedFrames`
HEIC	`heic`	`image.exif`, `image.gps`, `image.codes`, `image.colors`, `image.profiles`, `image.text`	Ninguna
HEIF	`heif`	`image.exif`, `image.gps`, `image.codes`, `image.colors`, `image.profiles`, `image.text`	Ninguna
HIF	`hif`	`image.exif`, `image.gps`, `image.codes`, `image.colors`, `image.profiles`, `image.text`	Ninguna
ICO	`ico`	`image.exif`, `image.gps`, `image.codes`, `image.colors`, `image.profiles`, `image.text`, `image.icons`	Ninguna
JPEG	`jpeg`	`image.exif`, `image.gps`, `image.codes`, `image.colors`, `image.profiles`, `image.text`	Ninguna
JPG	`jpg`	`image.exif`, `image.gps`, `image.codes`, `image.colors`, `image.profiles`, `image.text`	Ninguna
PNG	`png`	`image.exif`, `image.gps`, `image.codes`, `image.colors`, `image.profiles`, `image.text`	Ninguna
TIF	`tif`	`image.exif`, `image.gps`, `image.codes`, `image.colors`, `image.profiles`, `image.text`	Ninguna
TIFF	`tiff`	`image.exif`, `image.gps`, `image.codes`, `image.colors`, `image.profiles`, `image.text`	Ninguna
WEBP	`webp`	`image.exif`, `image.gps`, `image.codes`, `image.colors`, `image.profiles`, `image.text`, `image.frames`	`frameMode`, `frameIntervalSeconds`, `maxExtractedFrames`
AVI	`avi`	`video.audio`, `video.metadata`, `video.subtitles`, `video.frames`, `media.transcript`	`audioFormat`, `frameMode`, `frameIntervalSeconds`, `maxExtractedFrames`, `transcription.mode`
M4V	`m4v`	`video.audio`, `video.metadata`, `video.subtitles`, `video.frames`, `media.transcript`	`audioFormat`, `frameMode`, `frameIntervalSeconds`, `maxExtractedFrames`, `transcription.mode`
MKV	`mkv`	`video.audio`, `video.metadata`, `video.subtitles`, `video.frames`, `media.transcript`	`audioFormat`, `frameMode`, `frameIntervalSeconds`, `maxExtractedFrames`, `transcription.mode`
MOV	`mov`	`video.audio`, `video.metadata`, `video.subtitles`, `video.frames`, `media.transcript`	`audioFormat`, `frameMode`, `frameIntervalSeconds`, `maxExtractedFrames`, `transcription.mode`
MP4	`mp4`	`video.audio`, `video.metadata`, `video.subtitles`, `video.frames`, `media.transcript`	`audioFormat`, `frameMode`, `frameIntervalSeconds`, `maxExtractedFrames`, `transcription.mode`
WEBM	`webm`	`video.audio`, `video.metadata`, `video.subtitles`, `video.frames`, `media.transcript`	`audioFormat`, `frameMode`, `frameIntervalSeconds`, `maxExtractedFrames`, `transcription.mode`
AAC	`aac`	`audio.metadata`, `audio.artwork`, `audio.chapters`, `audio.chapterAudio`, `media.transcript`	`audioFormat`, `transcription.mode`
AIF	`aif`	`audio.metadata`, `audio.artwork`, `audio.chapters`, `audio.chapterAudio`, `media.transcript`	`audioFormat`, `transcription.mode`
AIFF	`aiff`	`audio.metadata`, `audio.artwork`, `audio.chapters`, `audio.chapterAudio`, `media.transcript`	`audioFormat`, `transcription.mode`
FLAC	`flac`	`audio.metadata`, `audio.artwork`, `audio.chapters`, `audio.chapterAudio`, `media.transcript`	`audioFormat`, `transcription.mode`
M4A	`m4a`	`audio.metadata`, `audio.artwork`, `audio.chapters`, `audio.chapterAudio`, `media.transcript`	`audioFormat`, `transcription.mode`
M4B	`m4b`	`audio.metadata`, `audio.artwork`, `audio.chapters`, `audio.chapterAudio`, `media.transcript`	`audioFormat`, `transcription.mode`
MKA	`mka`	`audio.metadata`, `audio.artwork`, `audio.chapters`, `audio.chapterAudio`, `media.transcript`	`audioFormat`, `transcription.mode`
MP3	`mp3`	`audio.metadata`, `audio.artwork`, `audio.chapters`, `audio.chapterAudio`, `media.transcript`	`audioFormat`, `transcription.mode`
OGG	`ogg`	`audio.metadata`, `audio.artwork`, `audio.chapters`, `audio.chapterAudio`, `media.transcript`	`audioFormat`, `transcription.mode`
OPUS	`opus`	`audio.metadata`, `audio.artwork`, `audio.chapters`, `audio.chapterAudio`, `media.transcript`	`audioFormat`, `transcription.mode`
WAV	`wav`	`audio.metadata`, `audio.artwork`, `audio.chapters`, `audio.chapterAudio`, `media.transcript`	`audioFormat`, `transcription.mode`
WMA	`wma`	`audio.metadata`, `audio.artwork`, `audio.chapters`, `audio.chapterAudio`, `media.transcript`	`audioFormat`, `transcription.mode`
ZIP	`zip`	`archive.images`, `archive.metadata`	Ninguna
EML	`eml`	`email.embeddedFiles`, `email.images`, `email.metadata`	Ninguna
EXE	`exe`	`executable.icons`	Ninguna

AnteriorDescubrimiento

SiguienteTodos los extractores