# Descubrimiento

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

## Opciones de un formato

```http
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.

```json
{
  "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

```http
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

```http
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

```http
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.