Lição 1 de 4 · 7 minutos

Faça uma solicitação

Envie sua chave de API, um ID de modelo e sua entrada para um endpoint compatível com OpenAI.

Toda solicitação vai para https://api.phaseo.app/v1 e leva a sua chave de API como token bearer: Authorization: Bearer phaseo_v1_sk_.... Crie a chave em Configurações -> Chaves de API. Ela é exibida uma única vez, então guarde-a em uma variável de ambiente como PHASEO_API_KEY e use-a só em código no servidor.

POST /v1/responses é o endpoint recomendado para novos trabalhos com texto. Você envia um model e um input:

curl https://api.phaseo.app/v1/responses \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-astra",
    "input": "Reply with: quickstart works"
  }'

Já usa o SDK oficial da OpenAI? Mude três coisas: a chave de API, a URL base e o ID do modelo.

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.PHASEO_API_KEY,
  baseURL: "https://api.phaseo.app/v1",
});

const response = await client.responses.create({
  model: "openai/gpt-6-astra",
  input: "Write one sentence about reliable model routing.",
});

console.log(response.output_text);

O código que chama Chat Completions funciona com o mesmo cliente: envie messages para client.chat.completions.create.

Os IDs de modelo sempre têm o prefixo do provedor, como openai/, anthropic/ ou google/. Para trocar de modelo, mude só a string model; o resto da solicitação continua igual. Liste os IDs válidos com GET /v1/models em vez de adivinhar. phaseo/free escolhe um modelo gratuito disponível e funciona sem créditos, o que é prático para um primeiro teste.

Confira o que você aprendeu

Você aponta o SDK oficial da OpenAI para o Phaseo. Quais mudanças são necessárias?

Aplique

O seu app envia "model": "gpt-6-astra" e a solicitação falha com 400. Um colega diz que o modelo deve estar fora do ar. O que você confere primeiro?

Mostrar a resposta

O ID do modelo. Os IDs de modelo do Phaseo incluem o prefixo do provedor, então deveria ser openai/gpt-6-astra. Um 400 aponta para o corpo da solicitação ou para o ID do modelo, não para uma indisponibilidade. Chame GET /v1/models para confirmar o ID exato.

Resumo

Uma URL base, uma chave bearer e um ID de modelo com prefixo do provedor bastam, e trocar de modelo é mudar uma string.

Links relacionados

O progresso fica salvo neste navegador.

Verificado em 17 de novembro de 2026