> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Comece com o roteador gratuito

> Comece com phaseo/free para executar sua primeira integração sem precisar escolher um modelo gratuito específico de antemão.

Use este guia para colocar sua primeira integração com a Phaseo em funcionamento sem escolher um modelo pago ainda.

Em vez de escolher um modelo gratuito por conta própria, envie as solicitações para `phaseo/free`. A Phaseo selecionará um modelo gratuito disponível que aceite a solicitação.

## Exemplo de solicitação

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.phaseo.app/v1/responses \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "phaseo/free",
      "input": "Summarize why provider-aware free routing helps prototypes.",
      "temperature": 0.2
    }'
  ```

  ```typescript TypeScript SDK theme={null}
  import Phaseo from "@phaseo/sdk";

  const client = new Phaseo({ apiKey: process.env.PHASEO_API_KEY! });

  const response = await client.generateResponse({
    model: "phaseo/free",
    input: "Summarize why provider-aware free routing helps prototypes.",
    temperature: 0.2,
  });

  console.log(response.output_text);
  ```

  ```python Python SDK theme={null}
  from phaseo import Phaseo

  client = Phaseo(api_key="YOUR_API_KEY")

  response = client.generate_response(
      {
          "model": "phaseo/free",
          "input": "Summarize why provider-aware free routing helps prototypes.",
          "temperature": 0.2,
      }
  )

  print(response.get("output_text"))
  ```

  ```go Go SDK theme={null}
  package main

  import (
    "context"
    "fmt"

    phaseo "github.com/phaseoteam/Phaseo/packages/sdk/sdk-go/v3"
  )

  func main() {
    client := phaseo.New("YOUR_API_KEY", "https://api.phaseo.app/v1")

    response, err := client.GenerateResponse(context.Background(), phaseo.ResponsesRequest{
      Model: "phaseo/free",
      Input: map[string]interface{}{
        "role": "user",
        "content": []map[string]string{
          {
            "type": "input_text",
            "text": "Summarize why provider-aware free routing helps prototypes.",
          },
        },
      },
    })
    if err != nil {
      panic(err)
    }

    fmt.Println(response)
  }
  ```

  ```csharp C# SDK theme={null}
  using PhaseoSdk;
  using System.Collections.Generic;

  var client = new Phaseo("YOUR_API_KEY");

  var response = await client.GenerateResponse(new Dictionary<string, object>
  {
      ["model"] = "phaseo/free",
      ["input"] = "Summarize why provider-aware free routing helps prototypes.",
      ["temperature"] = 0.2
  });

  Console.WriteLine(response);
  ```

  ```php PHP SDK theme={null}
  <?php
  require 'vendor/autoload.php';

  use Phaseo\Sdk\Phaseo;

  $client = new Phaseo(getenv('PHASEO_API_KEY') ?: 'YOUR_API_KEY');

  $response = $client->generateResponse([
      'model' => 'phaseo/free',
      'input' => 'Summarize why provider-aware free routing helps prototypes.',
      'temperature' => 0.2,
  ]);

  print_r($response);
  ```

  ```ruby Ruby SDK theme={null}
  require 'phaseo_sdk'

  client = PhaseoSdk::Phaseo.new(api_key: ENV.fetch('PHASEO_API_KEY', 'YOUR_API_KEY'))

  response = client.generate_response(
    model: 'phaseo/free',
    input: 'Summarize why provider-aware free routing helps prototypes.',
    temperature: 0.2
  )

  puts response
  ```
</CodeGroup>

## O que acontece nos bastidores

1. Sua solicitação vai para o alias compartilhado `phaseo/free`.
2. A Phaseo verifica quais modelos gratuitos podem atendê-la.
3. Um modelo gratuito disponível é selecionado e usado para gerar a resposta.
4. Os detalhes da solicitação ainda mostram o modelo exato executado para que você possa inspecioná-lo ou depurá-lo depois.

## Depois da primeira solicitação

* Em **Gateway -> Uso**, abra os detalhes da solicitação e confirme qual modelo foi usado.
* Se uma política do workspace bloquear a solicitação, consulte os detalhes para identificar a configuração que a interrompeu.
* Se nenhum modelo gratuito oferecer o recurso necessário, troque `phaseo/free` por um modelo pago específico em vez de repetir a mesma solicitação.

## Observações para produção

* Use `phaseo/free` em protótipos, demonstrações e tráfego de baixo risco.
* Se precisar de latência, estilo de saída ou escolha de provedor previsíveis, migre para um modelo específico quando souber qual funciona melhor.
* Se precisar de um comportamento de prompt estável entre serviços, combine este guia com [Presets](../guides/presets.mdx).

## Guias relacionados

* [Início rápido](../quickstart.mdx)
* [Roteamento e alternativas](../guides/routing-and-fallbacks.mdx)
* [Erros da API](../api-reference/errors.mdx)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.