Primeiros passos

A API da Norlen é compatível com OpenAI: qualquer SDK ou ferramenta que fala com a OpenAI funciona trocando a base URL e a chave. Em três passos você sai do zero à primeira resposta.

1. Crie sua conta

   Acesse o painel em app.norlen.io e cadastre-se com Google, GitHub ou e-mail e senha. Contas novas já começam no plano Free (modelo Gemma 4 12B, 5 requisições/min).

2. Gere sua API key

   No painel, abra Dashboard e copie sua API key. Ela autentica todas as chamadas — trate como senha e nunca a exponha no navegador ou em repositórios públicos.

   # Guarde a key numa variável de ambiente
   export NORLEN_API_KEY="sk-..."

3. Faça a primeira chamada

   Aponte seu cliente para https://api.norlen.io/v1 e use sua key como Bearer token.

   curl

   curl https://api.norlen.io/v1/chat/completions \
     -H "Authorization: Bearer $NORLEN_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "qwen3.6-35b",
       "messages": [{"role": "user", "content": "Explique embeddings em uma frase."}]
     }'

   Python

   from openai import OpenAI
   
   client = OpenAI(
       base_url="https://api.norlen.io/v1",
       api_key="seu-token",  # ou os.environ["NORLEN_API_KEY"]
   )
   
   resp = client.chat.completions.create(
       model="qwen3.6-35b",
       messages=[{"role": "user", "content": "Explique embeddings em uma frase."}],
   )
   print(resp.choices[0].message.content)

   Node.js

   import OpenAI from "openai";
   
   const client = new OpenAI({
     baseURL: "https://api.norlen.io/v1",
     apiKey: process.env.NORLEN_API_KEY,
   });
   
   const resp = await client.chat.completions.create({
     model: "qwen3.6-35b",
     messages: [{ role: "user", content: "Explique embeddings em uma frase." }],
   });
   console.log(resp.choices[0].message.content);

A resposta segue o formato OpenAI:

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "qwen3.6-35b",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Embeddings são..." },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 18, "completion_tokens": 24, "total_tokens": 42 }
}

Já usa a SDK da OpenAI?

Não precisa reescrever nada. Troque apenas base_url (Python) ou baseURL (Node) para https://api.norlen.io/v1 e use sua key da Norlen.

Próximos passos

Autenticação

Como as API keys funcionam, boas práticas de segurança e rotação. Ver autenticação →

Referência da API

Chat, embeddings e geração de imagem — endpoints e parâmetros. Ver API →