Descubrimiento

Usa los endpoints de descubrimiento para consultar formatos admitidos, opciones, límites y metadatos de los extractores.

Opciones de un formato

GET /options/{format}
X-Fast-Api-Key: YOUR_API_KEY

Usa este endpoint cuando vayas a construir el cuerpo de una solicitud a /estimate, /extract o /transcribe. Devuelve los valores válidos de selectedCapabilities y las claves de capabilityOptions permitidas para ese formato de origen.

Por ejemplo, GET /options/mp4 devuelve video.audio, video.metadata, video.subtitles, video.frames y media.transcript. Si seleccionas media.transcript, usa la opción transcription.mode devuelta y uno de sus valores permitidos.

{
  "format": "mp4",
  "job": "extract.mp4",
  "defaults": {
    "selectedCapabilities": ["video.audio", "video.frames", "video.metadata", "video.subtitles"],
    "includeManifest": true,
    "capabilityOptions": {
      "video.audio": {
        "audioFormat": "mp3"
      },
      "video.frames": {
        "frameMode": "evenly-spaced",
        "frameIntervalSeconds": 1,
        "maxExtractedFrames": 500
      }
    }
  },
  "capabilities": [
    {
      "id": "media.transcript",
      "output": "transcript",
      "defaultSelected": false,
      "options": [
        {
          "id": "transcription.mode",
          "type": "enum",
          "required": true,
          "defaultValue": "fast",
          "allowedValues": ["fast", "quality", "meeting-intelligence"]
        }
      ]
    }
  ]
}

Listar extractores

GET /extractors
X-Fast-Api-Key: YOUR_API_KEY

Devuelve los extractores registrados con sus formatos de origen, categorías, metadatos de coste y límites.

Tipo de archivo de origen

GET /extractors/{sourceFileType}

Usa este endpoint cuando necesites metadatos del extractor para una extensión concreta. Por ejemplo, GET /extractors/mp4 devuelve los trabajos de Extract que aceptan entradas MP4. Usa GET /options/mp4 cuando necesites construir el JSON real de selectedCapabilities y capabilityOptions.

Esquema

GET /schema
X-Fast-Api-Key: YOUR_API_KEY

Devuelve un esquema compacto de formatos admitidos para clientes de API que solo necesitan descubrir extensiones y grupos de salida. Prefiere GET /options/{format} cuando tengas que construir un JSON de opciones válido.

Alcance público de descubrimiento

Usa los endpoints de descubrimiento documentados en esta página al crear clientes de API.