Autenticação

O Ignus Code usa API keys para autenticar requisições. Todas as requests à API devem incluir sua key no header Authorization.

Criar uma API key

1. Acesse o Dashboard
2. Vá em API Keys → Nova Key
3. Dê um nome descritivo (ex: prod, dev, app-backend)
4. Copie o valor gerado — ele aparece uma única vez

Usar a API key

Inclua a key no header Authorization como Bearer token:

Authorization: Bearer sk_ic_xxxxxxxxxxxxxxxxxxxx

Exemplo com cURL

curl https://proxy.ignustec.com.br/v1/chat/completions \
  -H "Authorization: Bearer $IGNUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Olá"}]}'

Exemplo com Python

import os
from openai import OpenAI
 
client = OpenAI(
    base_url="https://proxy.ignustec.com.br/v1",
    api_key=os.environ["IGNUS_API_KEY"],
)

Exemplo com TypeScript

import OpenAI from "openai";
 
const client = new OpenAI({
  baseURL: "https://proxy.ignustec.com.br/v1",
  apiKey: process.env.IGNUS_API_KEY,
});

Boas práticas

Use variáveis de ambiente — nunca coloque a key diretamente no código.

# .env.local
IGNUS_API_KEY=sk_ic_xxxxxxxxxxxxxxxxxxxx

# .gitignore
.env
.env.local

Crie keys separadas por ambiente — use uma key para prod e outra para dev, assim você pode revogar uma sem afetar a outra.

Revogue keys comprometidas — se uma key vazar, vá ao Dashboard → API Keys e delete imediatamente.

Erros de autenticação

Veja mais em Erros.