Modelos de agente | Firecrawl

Firecrawl Agent ofrece tres modelos optimizados para distintos casos de uso. Elige el modelo adecuado en función de la complejidad de la extracción y tus requisitos de costos.

Modelos disponibles

Modelo	Costo	Precisión	Ideal para
`spark-2`	El más bajo	Comparable a Pro	Bajo costo y tiempo de ejecución corto
`spark-1-mini`	60 % más económico que Pro	Estándar	Cargas de trabajo de Spark 1 donde el costo es importante
`spark-1-pro`	Estándar	Mayor	Investigación compleja, extracción crítica (predeterminado)

Spark 1 Pro es el modelo predeterminado, por lo que una solicitud sin el parámetro model usa spark-1-pro. Establece model en spark-2 para obtener un costo menor y un tiempo de ejecución más corto con una precisión comparable. Establece model en spark-1-mini para obtener un costo un 60 % menor en tareas simples de Spark 1.

Spark 2

spark-2 es nuestro modelo de agente más reciente. Elimina la disyuntiva entre precisión y costo: es más económico y rápido que ambos modelos Spark 1, iguala la precisión de Spark 1 Pro y completa una mayor proporción de ejecuciones. Configura model como spark-2 para usarlo. Usa Spark 2 cuando:

Quieres el menor costo por ejecución
El tiempo de ejecución es importante
De otro modo optarías por la precisión de Spark 1 Pro

Casos de uso de ejemplo:

Todo lo que hoy ejecutas con Spark 1 Mini o Spark 1 Pro
Extracción de alto volumen en la que el costo por ejecución determina el presupuesto
Investigación multidominio que necesita resultados rápidos

Spark 1 Mini

spark-1-mini es nuestro modelo eficiente, ideal para tareas sencillas de extracción de datos. Usa Mini cuando:

Necesites extraer datos simples (información de contacto, precios, etc.)
Trabajes con sitios web bien estructurados
El ahorro de costos sea una prioridad
Debas ejecutar trabajos de extracción de alto volumen

Ejemplos de casos de uso:

Extraer precios de productos de sitios de comercio electrónico
Recopilar información de contacto de páginas de empresas
Extraer metadatos básicos de artículos
Realizar consultas sencillas de datos específicos

Spark 1 Pro (Predeterminado)

spark-1-pro es nuestro modelo insignia, diseñado para lograr la máxima precisión en tareas de extracción complejas. Es el predeterminado: una solicitud que no establece model usa spark-1-pro. Usa Pro cuando:

Realices análisis de la competencia complejos
Extraigas datos que requieran razonamiento profundo
La precisión sea crítica para tu caso de uso
Tengas que manejar datos ambiguos o difíciles de encontrar

Ejemplos de casos de uso:

Análisis de la competencia multidominio
Tareas de investigación complejas que requieran razonamiento
Extracción de información detallada y matizada desde múltiples fuentes
Obtención de inteligencia empresarial crítica

Especificar un modelo

spark-1-pro es el modelo predeterminado, por lo que el parámetro model es opcional. Pásalo para seleccionar otro modelo:

from firecrawl import Firecrawl

app = Firecrawl(api_key="fc-YOUR_API_KEY")

# Usando Spark 2 (no es el predeterminado - configúralo explícitamente)
result = app.agent(
    prompt="Find the pricing of Firecrawl",
    model="spark-2"
)

# Usando Spark 1 Mini
result = app.agent(
    prompt="Find the pricing of Firecrawl",
    model="spark-1-mini"
)

# Usando Spark 1 Pro (el predeterminado) para tareas complejas
result = app.agent(
    prompt="Compare all enterprise features and pricing across Firecrawl, Apify, and ScrapingBee",
    model="spark-1-pro"
)

print(result.data)

import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({ apiKey: "fc-YOUR_API_KEY" });

// Usando Spark 2 (no es el predeterminado - especifícalo explícitamente)
const resultSpark2 = await firecrawl.agent({
  prompt: "Find the pricing of Firecrawl",
  model: "spark-2"
});

// Usando Spark 1 Mini
const result = await firecrawl.agent({
  prompt: "Find the pricing of Firecrawl",
  model: "spark-1-mini"
});

// Usando Spark 1 Pro (el predeterminado) para tareas complejas
const resultPro = await firecrawl.agent({
  prompt: "Compare all enterprise features and pricing across Firecrawl, Apify, and ScrapingBee",
  model: "spark-1-pro"
});

console.log(result.data);

# Using Spark 2 (not the default - set it explicitly)
curl -X POST "https://api.firecrawl.dev/v2/agent" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Find the pricing of Firecrawl",
    "model": "spark-2"
  }'

# Using Spark 1 Mini
curl -X POST "https://api.firecrawl.dev/v2/agent" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Find the pricing of Firecrawl",
    "model": "spark-1-mini"
  }'

# Using Spark 1 Pro (the default) for complex tasks
curl -X POST "https://api.firecrawl.dev/v2/agent" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Compara todas las características empresariales y precios entre Firecrawl, Apify y ScrapingBee",
    "model": "spark-1-pro"
  }'

Comparación de modelos

Característica	Spark 2	Spark 1 Mini	Spark 1 Pro
Costo	El más bajo	Un 60 % más barato que Pro	Standard
Precisión	Comparable a Pro	Estándar	Mayor
Velocidad	El más rápido	Rápido	Rápido
Ideal para	Todo tipo de tareas	La mayoría de las tareas	Tareas complejas
Razonamiento	Avanzado	Estándar	Avanzado
Multidominio	Excelente	Bueno	Excelente

Precios por modelo

Todos los modelos usan precios dinámicos basados en créditos que se adaptan a la complejidad de la tarea:

Spark 2: Usa considerablemente menos créditos que cualquiera de los modelos Spark 1 para tareas equivalentes
Spark 1 Mini: Usa aproximadamente un 60 % menos de créditos que Pro para tareas equivalentes
Spark 1 Pro: Consumo estándar de créditos para máxima precisión

El uso de créditos varía según la complejidad del prompt, los datos procesados y la estructura del resultado, independientemente del modelo seleccionado.

Seleccionar el modelo adecuado

Spark 2 abarca ambas ramas siguientes. El árbol se aplica al elegir entre los dos modelos de Spark 1:

                    ┌─────────────────────────────────┐
                    │   What type of task?            │
                    └─────────────────────────────────┘
                                   │
                    ┌──────────────┴──────────────┐
                    ▼                             ▼
          ┌─────────────────┐           ┌─────────────────┐
          │  Simple/Directa │           │ Compleja/Investigación│
          │  extracción     │           │ multidominio    │
          └─────────────────┘           └─────────────────┘
                    │                             │
                    ▼                             ▼
          ┌─────────────────┐           ┌─────────────────┐
          │  spark-1-mini   │           │  spark-1-pro    │
          │  (60% cheaper)  │           │  (higher acc.)  │
          └─────────────────┘           └─────────────────┘

Referencia de la API

Consulta la Referencia de la API del agente para obtener la documentación completa de los parámetros. ¿Tienes preguntas sobre qué modelo usar? Envía un correo a help@firecrawl.com.

¿Eres un agente de IA que necesita una clave de API de Firecrawl? Consulta firecrawl.dev/agent-onboarding/SKILL.md para obtener instrucciones de incorporación automatizadas.

Get Started

Core Endpoints

More

Quickstarts

Developer Guides

Webhooks

Use Cases

Other

Contributing

Modelos

Modelos disponibles

Spark 2

Spark 1 Mini

Spark 1 Pro (Predeterminado)

Especificar un modelo

Comparación de modelos

Precios por modelo

Seleccionar el modelo adecuado

Referencia de la API

​Modelos disponibles

​Spark 2

​Spark 1 Mini

​Spark 1 Pro (Predeterminado)

​Especificar un modelo

​Comparación de modelos

​Precios por modelo

​Seleccionar el modelo adecuado

​Referencia de la API

Modelos disponibles

Spark 2

Spark 1 Mini

Spark 1 Pro (Predeterminado)

Especificar un modelo

Comparación de modelos

Precios por modelo

Seleccionar el modelo adecuado

Referencia de la API