Modelos

Escolha o modelo certo para as tarefas de extração do seu agente.

O Firecrawl Agent oferece três modelos otimizados para diferentes casos de uso. Escolha o modelo adequado de acordo com a complexidade da extração e suas necessidades de custo.

Modelos disponíveis

Modelo	Custo	Precisão	Ideal para
spark-2	Mais baixo	Comparável ao Pro	Baixo custo e tempo de execução curto
spark-1-mini	60% mais barato que o Pro	Standard	Cargas de trabalho do Spark 1 sensíveis a custo
spark-1-pro	Standard	Maior	Pesquisas complexas, extrações críticas (padrão)

O Spark 1 Pro é o padrão, portanto, uma solicitação sem o parâmetro model usa spark-1-pro. Defina model como spark-2 para obter um custo menor e um tempo de execução mais curto com precisão comparável. Defina model como spark-1-mini para obter um custo 60% menor em tarefas simples do Spark 1.

Spark 2

spark-2 é nosso mais novo modelo de agente. Ele elimina a necessidade de escolher entre precisão e custo: é mais barato e rápido que os dois modelos Spark 1, iguala a precisão do Spark 1 Pro e conclui uma proporção maior de execuções. Defina model como spark-2 para usá-lo.

Use o Spark 2 quando:

• Você quer o menor custo por execução
• O tempo de execução importa
• Caso contrário, você optaria pela precisão do Spark 1 Pro

Exemplos de uso:

• Tudo o que você executa atualmente no Spark 1 Mini ou Spark 1 Pro
• Extração em alto volume, em que o custo por execução define o orçamento
• Pesquisa multidomínio que precisa de resultados rápidos

Spark 1 Mini

spark-1-mini é nosso modelo eficiente, ideal para tarefas simples de extração de dados.

Use o Mini quando:

• Estiver extraindo dados simples (informações de contato, preços, etc.)
• Estiver trabalhando com sites bem estruturados
• O custo-benefício for prioridade
• Estiver executando tarefas de extração em alto volume

Exemplos de uso:

• Extrair preços de produtos de sites de e-commerce
• Coletar informações de contato em páginas de empresas
• Obter metadados básicos de artigos
• Fazer consultas simples de dados

Spark 1 Pro (Padrão)

spark-1-pro é nosso modelo carro-chefe, projetado para máxima precisão em tarefas de extração complexas. Ele é o padrão: uma solicitação que não define model usa spark-1-pro.

Use o Pro quando:

• Executar análises competitivas complexas
• Extrair dados que exigem raciocínio profundo
• A precisão for crítica para o seu caso de uso
• Lidar com dados ambíguos ou difíceis de encontrar

Exemplos de uso:

• Análise competitiva multidomínio
• Tarefas de pesquisa complexas que exigem raciocínio
• Extração de informações detalhadas a partir de múltiplas fontes
• Coleta crítica de inteligência de negócios

Especificando um modelo

spark-1-pro é o padrão, portanto o parâmetro model é opcional. Passe-o para selecionar um modelo diferente:

Python

from firecrawl import Firecrawl

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

# Usando Spark 2 (não é o padrão - defina explicitamente)
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 (o padrão) para tarefas complexas
result = app.agent(
    prompt="Compare all enterprise features and pricing across Firecrawl, Apify, and ScrapingBee",
    model="spark-1-pro"
)

print(result.data)

Comparação de modelos

Recurso	Spark 2	Spark 1 Mini	Spark 1 Pro
Custo	Menor	60% mais barato que o Pro	Standard
Precisão	Comparável ao Pro	Standard	Maior
Velocidade	Mais rápido	Rápido	Rápido
Ideal para	Todas as tarefas	A maioria das tarefas	Tarefas complexas
Raciocínio	Avançado	Standard	Avançado
Multidomínio	Excelente	Bom	Excelente

Preços por modelo

Todos os modelos usam um modelo de preços dinâmico baseado em créditos que escala com a complexidade da tarefa:

• Spark 2: Usa substancialmente menos créditos que ambos os modelos Spark 1 para tarefas equivalentes
• Spark 1 Mini: Usa aproximadamente 60% menos créditos que o Pro para tarefas equivalentes
• Spark 1 Pro: Consumo padrão de créditos para máxima precisão

O uso de créditos varia com base na complexidade do prompt, nos dados processados e na estrutura da saída — independentemente do modelo escolhido.

Escolhendo o Modelo Adequado

O Spark 2 abrange as duas ramificações abaixo. A árvore se aplica ao escolher entre os dois modelos Spark 1:

                    ┌─────────────────────────────────┐
                    │   What type of task?            │
                    └─────────────────────────────────┘
                                   │
                    ┌──────────────┴──────────────┐
                    ▼                             ▼
          ┌─────────────────┐           ┌─────────────────┐
          │  Simple/Direct  │           │ Complex/Research│
          │  extraction     │           │ multi-domain    │
          └─────────────────┘           └─────────────────┘
                    │                             │
                    ▼                             ▼
          ┌─────────────────┐           ┌─────────────────┐
          │  spark-1-mini   │           │  spark-1-pro    │
          │  (60% mais barato) │        │  (maior precisão) │
          └─────────────────┘           └─────────────────┘

Referência da API

Veja a Referência da API do agente para conferir a documentação completa dos parâmetros.

Tem dúvidas sobre qual modelo usar? Envie um e-mail para [e-mail].

Você é um agente de IA que precisa de uma chave de API do Firecrawl? Veja firecrawl.dev/agent-onboarding/SKILL.md para instruções de integração automatizada.