Pular para o conteúdo
GREATROUTER
Começar
Como funcionaModelosRecursosDocsStudios Entrar Começar

Primeiros passos

Este guia acompanha você na primeira inferência com a API do GreatRouter.

1. Obtenha sua chave API

Cadastre-se no painel do GreatRouter para obter sua chave API. Cada conta nova inclui créditos gratuitos.

Configure a variável de ambiente:

Terminal window
export GREAT_ROUTER_API_KEY="pk_live_..."

2. Faça sua primeira solicitação

O GreatRouter usa o endpoint /v1/auto/route para roteamento automático de prompts. Envie seu prompt e a entrada do modelo; o roteador seleciona o melhor modelo.

Com curl

Terminal window
curl https://api.greatrouterai.com/v1/auto/route \
  -H "Authorization: Bearer $GREAT_ROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Qual é a capital da França?",
    "input": {
      "messages": [{"role": "user", "content": "Qual é a capital da França?"}]
    }
  }'

Com Python

import requests


response = requests.post(
    "https://api.greatrouterai.com/v1/auto/route",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "Qual é a capital da França?",
        "input": {
            "messages": [{"role": "user", "content": "Qual é a capital da França?"}]
        },
    },
)


result = response.json()
print(result["result"]["choices"][0]["message"]["content"])

Com Node.js

const response = await fetch('https://api.greatrouterai.com/v1/auto/route', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.GREAT_ROUTER_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    prompt: 'Qual é a capital da França?',
    input: {
      messages: [{ role: 'user', content: 'Qual é a capital da França?' }],
    },
  }),
});


const result = await response.json();
console.log(result.result.choices[0].message.content);

3. Especifique um modelo diretamente

Se preferir um modelo específico em vez do roteamento automático, use /v1/models/route com uma consulta explícita:

Terminal window
curl https://api.greatrouterai.com/v1/models/route \
  -H "Authorization: Bearer $GREAT_ROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "text_generation",
    "input": {
      "model": "meta/llama-3.3-70b-instruct-fp8-fast",
      "messages": [{"role": "user", "content": "Explique computação quântica em 3 frases."}]
    }
  }'

Os IDs de modelo usam o formato provedor/nome-do-modelo. Explore todos os modelos em Modelos.

4. Explore mais