Um endpoint. Todos os modelos.

No painel, em Chaves de API, clique em Criar chave. O segredo aparece uma única vez — copie antes de sair da tela.

curl https://api.novality.com.br/v1/chat/completions \  -H "Authorization: Bearer nv_live_SUA_CHAVE" \  -H "Content-Type: application/json" \  -d '{    "model": "claude-fable-5",    "messages": [{"role": "user", "content": "Olá"}]  }'

A resposta vem no formato da OpenAI:

{  "id": "chatcmpl_a0398abf7ed143df89a5",  "object": "chat.completion",  "model": "claude-fable-5",  "choices": [{    "index": 0,    "message": { "role": "assistant", "content": "Olá! Como posso ajudar?" },    "finish_reason": "stop"  }],  "usage": { "prompt_tokens": 12, "completion_tokens": 8, "total_tokens": 20 }}

Instale openai e aponte a base_url para a Novality. O resto do seu código não muda.

from openai import OpenAIimport os client = OpenAI(    base_url="https://api.novality.com.br/v1",    api_key=os.environ["NOVALITY_API_KEY"],) resposta = client.chat.completions.create(    model="claude-fable-5",    messages=[{"role": "user", "content": "Olá"}],)print(resposta.choices[0].message.content)

import OpenAI from "openai"; const client = new OpenAI({  baseURL: "https://api.novality.com.br/v1",  apiKey: process.env.NOVALITY_API_KEY,}); const resposta = await client.chat.completions.create({  model: "claude-fable-5",  messages: [{ role: "user", content: "Olá" }],});console.log(resposta.choices[0].message.content);

Envie stream: true e receba os tokens incrementalmente em SSE:

stream = client.chat.completions.create(    model="claude-fable-5",    messages=[{"role": "user", "content": "Escreva um poema"}],    stream=True,) for pedaco in stream:    delta = pedaco.choices[0].delta.content or ""    print(delta, end="", flush=True)

data: {"object":"chat.completion.chunk","choices":[{"delta":{"content":"Olá"}}]}data: {"object":"chat.completion.chunk","choices":[{"delta":{"content":"!"}}]}data: {"object":"chat.completion.chunk","choices":[{"delta":{},"finish_reason":"stop"}]}data: [DONE]

Para receber a contagem de tokens no fim do stream, peça stream_options: { include_usage: true }:

stream = client.chat.completions.create(    model="claude-fable-5",    messages=[{"role": "user", "content": "Escreva um poema"}],    stream=True,    stream_options={"include_usage": True},) for pedaco in stream:    if pedaco.usage:        print("\n", pedaco.usage.prompt_tokens, "->", pedaco.usage.completion_tokens)    else:        print(pedaco.choices[0].delta.content or "", end="", flush=True)

Sem include_usage a API não manda o bloco de uso — é o comportamento padrão da OpenAI. O consumo continua sendo registrado no painel de Uso da API de qualquer forma.

Consulte GET /v1/models para pegar os nomes exatos:

curl https://api.novality.com.br/v1/models \  -H "Authorization: Bearer nv_live_SUA_CHAVE"

• claude-fable-5
• claude-fable-5.1
• claude-opus-5
• claude-opus-5.5
• deepseek-v4-pro-0813
• gpt-5.5
• gpt-5.5-pro
• gpt-5.6-luna

Toda resposta de erro segue o formato { error: { message, type, code, param } }, com o code estável para tratar por código.

Toda requisição passa por um controle por chave e um global antes de consumir o provedor. Ao estourar, a resposta vem com Retry-After:

Requisições por minuto (chave)

60

Requisições por minuto (conta interna)

120

Requisições por minuto (global)

2.400

Pico em rajada

10

Streams simultâneos (chave)

3

Tamanho máximo do corpo

1 MiB

Tempo máximo de resposta

120 s

• ✓A chave fica no servidor. Nunca exponha no frontend do seu app nem versione no git.
• ✓Use uma chave por ambiente (produção, staging) para revogar sem quebrar nada.
• ✓Gire a chave se ela vazar: revogue e crie outra na hora.