Documentacao da API

Endpoint Base

A API e 100% compativel com o formato da API OpenAI. Voce pode usar qualquer SDK ou biblioteca compativel.

Autenticacao

Todas as requisicoes autenticadas devem incluir o header Authorization com seu Bearer token.

Authorization: Bearer lgo-your_api_key_here

Obtenha sua API key no painel de API Keys.

Endpoints

Exemplo de requisicao

curl https://liviago.com.br/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer lgo-your_api_key" \
  -d '{
    "model": "m9-flash",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ],
    "temperature": 0.7,
    "max_tokens": 1024
  }'

Exemplo de resposta

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1711728000,
  "model": "m9-flash",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Hello! How can I help you today?"
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 9,
    "total_tokens": 34
  }
}

curl https://liviago.com.br/api/v1/models

curl https://liviago.com.br/api/v1/usage \
  -H "Authorization: Bearer lgo-your_api_key"

Modelos Disponiveis

ID do Modelo	Nome	Descricao
m9-flash	M9 Flash	Modelo rapido para tarefas gerais. Baixo custo, alta velocidade.
m9-pro	M9 Pro	Modelo avancado com reasoning. Maior qualidade, ideal para tarefas complexas.

Limites por Plano

Os limites sao compartilhados entre Chatbot, Marc Code e API. Credito consumido pela API conta no mesmo saldo.

Plano	Credito Mensal	Credito Semanal	Janela 5h
Free	R$ 3,07	R$ 1,23	R$ 0,06
Associative	R$ 6,14	R$ 2,46	R$ 0,12
Pro	R$ 60,00	R$ 15,00	R$ 0,75
Premium	R$ 250,00	R$ 62,50	R$ 3,13
Ultra	R$ 985,00	R$ 246,25	R$ 12,31

Codigos de Erro

HTTP	Codigo	Significado
401	invalid_api_key	API key invalida, revogada ou ausente.
400	invalid_request	Corpo da requisicao invalido ou modelo nao encontrado.
429	rate_limit_exceeded	Limite de uso excedido. Aguarde ou faca upgrade do plano.
502	upstream_error	Erro no servico upstream (proxy M9).

Uso com SDKs

Como a API e compativel com OpenAI, voce pode usar os SDKs oficiais apontando para o endpoint LiviaGO.

Python (openai)

# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="lgo-your_api_key",
    base_url="https://liviago.com.br/api/v1",
)

response = client.chat.completions.create(
    model="m9-flash",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)

Node.js (openai)

// npm install openai
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'lgo-your_api_key',
  baseURL: 'https://liviago.com.br/api/v1',
});

const response = await client.chat.completions.create({
  model: 'm9-flash',
  messages: [{ role: 'user', content: 'Hello!' }],
});
console.log(response.choices[0].message.content);