> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-docs-prompt-injection-screening.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<div id="available-models">
  ## Modelos disponíveis
</div>

| 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) |

<Tip>
  **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.
</Tip>

<div id="spark-2">
  ## Spark 2
</div>

`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

<div id="spark-1-mini">
  ## Spark 1 Mini
</div>

`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

<div id="spark-1-pro-default">
  ## Spark 1 Pro (Padrão)
</div>

`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

<div id="specifying-a-model">
  ## Especificando um modelo
</div>

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

<CodeGroup>
  ```python Python theme={null}
  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)
  ```

  ```js Node theme={null}
  import { Firecrawl } from 'firecrawl';

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

  // Usando Spark 2 (não é o padrão - defina explicitamente)
  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 (o padrão) para tarefas complexas
  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);
  ```

  ```bash cURL theme={null}
  # Usando Spark 2 (não é o padrão - defina explicitamente)
  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"
    }'

  # Usando 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"
    }'

  # Usando Spark 1 Pro (o padrão) para tarefas complexas
  curl -X POST "https://api.firecrawl.dev/v2/agent" \
    -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "prompt": "Compare all enterprise features and pricing across Firecrawl, Apify, and ScrapingBee",
      "model": "spark-1-pro"
    }'
  ```
</CodeGroup>

<div id="model-comparison">
  ## Comparação de modelos
</div>

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

<div id="pricing-by-model">
  ## Preços por modelo
</div>

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

<Info>
  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.
</Info>

<div id="choosing-the-right-model">
  ## Escolhendo o Modelo Adequado
</div>

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) │
          └─────────────────┘           └─────────────────┘
```

<div id="api-reference">
  ## Referência da API
</div>

Veja a [Referência da API do agente](/pt-BR/api-reference/endpoint/agent) para conferir a documentação completa dos parâmetros.

Tem dúvidas sobre qual modelo usar? Envie um e-mail para [help@firecrawl.com](mailto:help@firecrawl.com).

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