Estimar

POST /estimate/{sourceFileExtension} calcula una cotización para un archivo y un JSON de opciones sin subir el archivo.

Buscar opciones válidas

Llama a GET /options/{format} antes de construir un JSON de opciones. Devuelve los ids de capacidades válidos, las selecciones predeterminadas y los valores de opción permitidos para ese formato de origen.

GET /options/mp4
X-Fast-Api-Key: YOUR_API_KEY

{
  "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": "video.audio",
      "output": "audio",
      "defaultSelected": true,
      "options": [
        {
          "id": "audioFormat",
          "type": "enum",
          "defaultValue": "mp3",
          "allowedValues": ["mp3", "wav", "m4a", "original", "best"]
        }
      ]
    },
    {
      "id": "media.transcript",
      "output": "transcript",
      "defaultSelected": false,
      "options": [
        {
          "id": "transcription.mode",
          "type": "enum",
          "required": true,
          "defaultValue": "fast",
          "allowedValues": ["fast", "quality", "meeting-intelligence"]
        }
      ]
    }
  ]
}

Usa capabilities[].id dentro de options.extraction.selectedCapabilities. Si una capacidad seleccionada tiene options[], coloca cada valor en options.extraction.capabilityOptions[capability.id][option.id].

Petición

POST /estimate/mp4
Content-Type: application/json
X-Fast-Api-Key: YOUR_API_KEY

{
  "fileSizeMb": 25,
  "durationMinutes": 3,
  "options": {
    "extraction": {
      "selectedCapabilities": ["video.audio", "video.metadata", "media.transcript"],
      "capabilityOptions": {
        "media.transcript": {
          "transcription.mode": "quality"
        }
      }
    }
  }
}

Parámetros de ruta

Parámetro	Obligatorio	Notas
`sourceFileExtension`	Sí	Extensión de origen con o sin punto, como `mp4`, `pdf`, `docx` o `zip`.

Campos

Campo	Obligatorio	Notas
`fileSizeBytes` o `fileSizeMb`	Sí	Se usa para precios por crédito de archivo y para límites.
`durationSeconds` o `durationMinutes`	Recomendado para audio/video	Ayuda a estimar trabajos de medios y transcripción basados en duración.
`pageCount`, `slideCount`, `sheetCount`, `documentUnitCount`	Recomendado para documentos	Usa la métrica que coincida con el tipo de origen cuando la conozcas.
`frameCount`	Recomendado para imágenes con varios fotogramas	Ayuda a estimar imágenes animadas y de múltiples fotogramas.
`workflow`	No	`extract` de forma predeterminada; usa `transcribe` para estimaciones solo de transcripción.
`mode`	Para anular el modo solo-transcripción	`fast`, `quality` o `meeting-intelligence`.
`options`	No	El mismo objeto de opciones de extracción que acepta `POST /extract`.

Respuesta

{
  "job": "extract.mp4",
  "category": "video",
  "quotedCredits": 16,
  "lineItems": [
    {
      "kind": "base",
      "credits": 1
    },
    {
      "kind": "capability",
      "capabilityId": "media.transcript",
      "credits": 15,
      "mode": "quality",
      "unit": "minute"
    }
  ]
}

Cotización de créditos

quotedCredits es el coste cotizado en créditos para el archivo y el JSON de opciones. lineItems desglosa esa cotización entre extracción base y complementos seleccionados con coste adicional.

AnteriorLímites de uso

SiguienteExtraer