Introdução

Retrace é um gateway de IA moderno que fica entre a sua aplicação e os modelos de LLM, oferecendo roteamento inteligente, fallback automático e uma API unificada.

Como funciona

Usando o SDK da OpenAI, basta apontar o baseURL para o endereço de API https://retrace.com.br/api/v1. A Retrace encaminha a requisição ao provedor selecionado e, em caso de falha, o roteamento automático redireciona a chamada para um modelo equivalente em qualidade, esforço, preço e contexto — garantindo que a sua aplicação continue funcionando sem interrupções.

Benefícios de um gateway

• Controle de gastos: saiba exatamente quanto a sua empresa gasta com IA.
• Roteamento inteligente: sem interrupções mesmo se um provedor estiver fora do ar.
• Gerenciamento de requisições: controle facilmente como as requisições devem acontecer.
• Variedade: acesse dezenas de modelos com uma única integração.

Comece a usar

Para começar a usar a Retrace, crie uma conta em retrace.com.br e configure um workspace — o espaço onde você vai gerenciar seus projetos e chaves de API.

Autenticação

1. Acesse retrace.com.br.
2. Escolha um método de autenticação: Google ou GitHub.
3. Na tela de onboarding, dê um nome ao seu workspace.

Criar chave de API

1. Acesse a página API Keys e clique em Adicionar chave.
2. Dê um nome à sua chave e clique em Criar chave.
3. Copie a chave gerada e guarde-a em um local seguro, como uma variável de ambiente RETRACE_API_KEY.

Com a chave de API em mãos, você já pode fazer requisições à Retrace. Veja abaixo um exemplo usando o SDK da OpenAI.

import OpenAI from "openai";

const openai = new OpenAI({ 
  baseURL: 'https://retrace.com.br/api/v1', 
  apiKey: process.env.RETRACE_API_KEY, 
});

const completion = await openai.chat.completions.create({ 
  messages: [{ 
    role: "user", 
    content: "Conte-me uma piada." 
  }], 
  model: "gpt-5.2", 
});

console.log(completion.choices[0].message.content);