Visão geral da API

A API da Norlen segue o padrão OpenAI-compatible. Qualquer SDK ou ferramenta que fala com a OpenAI funciona trocando a base URL e a chave — sem reescrever a integração.

Base URLs

Recurso	Método e endpoint
Chat / texto	POST https://api.norlen.io/v1/chat/completions
Embeddings	POST https://api.norlen.io/v1/embeddings
Modelos	GET https://api.norlen.io/v1/models
Geração de imagem	POST https://app.norlen.io/api/v1/images/generations

A base URL da imagem é diferente

Texto, embeddings e modelos ficam em api.norlen.io/v1. A geração de imagem fica em app.norlen.io/api/v1. A autenticação (Bearer key) é a mesma nos dois.

Autenticação

Todas as chamadas usam o header Authorization: Bearer SUA_API_KEY. Veja Autenticação para detalhes e boas práticas.

Configurando um SDK

Aponte a SDK oficial da OpenAI para a Norlen:

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.norlen.io/v1",
    api_key="seu-token",
)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.norlen.io/v1",
  apiKey: process.env.NORLEN_API_KEY,
});

Modelos

Use o id exato do modelo na chamada. Catálogo completo em Modelos.

Modelo	id	Uso
Qwen3.6 35B	qwen3.6-35b	Chat geral, raciocínio
Qwen3 Coder	qwen3-coder	Código
Gemma 4 12B	gemma-4-12b	Respostas rápidas (Free)
Qwen3 Embedding	qwen3-embedding	Embeddings
Qwen-Image	qwen-image	Geração de imagem

Referência por endpoint

• Chat completions — geração de texto, incluindo streaming
• Embeddings — vetores para busca semântica e RAG
• Geração de imagem — imagens a partir de texto
• Modelos — lista os modelos do seu plano
• Erros & limites — códigos de status e rate limits