Documentação

Obtenha sua chave

Crie sua conta em nossa plataforma e gere sua primeira API key. Uma chave única que funciona com todos os modelos e formatos compatíveis.

Primeira chamada à API

Use o endpoint compatível com OpenAI para fazer sua primeira requisição. Substitua $APIARIO_KEY pela sua chave.

curl https://api.apiario.dev/v1/chat/completions \
  -H "Authorization: Bearer $APIARIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "maritaca/sabia-4",
    "messages": [
      {"role": "user", "content": "Olá! Quem é você?"}
    ]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://api.apiario.dev/v1",
    api_key="$APIARIO_KEY"
)

response = client.chat.completions.create(
    model="maritaca/sabia-4",
    messages=[
        {"role": "user", "content": "Olá! Quem é você?"}
    ]
)

print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.apiario.dev/v1",
  apiKey: process.env.APIARIO_KEY,
});

const response = await client.chat.completions.create({
  model: "maritaca/sabia-4",
  messages: [
    { role: "user", content: "Olá! Quem é você?" }
  ],
});

console.log(response.choices[0].message.content);

Modelos e Preços

Consulte a lista completa de modelos disponíveis via GET /v1/models. Os preços são exibidos em Reais (BRL) por 1 milhão de tokens, tanto para entrada quanto para saída.

curl https://api.apiario.dev/v1/models \
  -H "Authorization: Bearer $APIARIO_KEY"

Tokens e Uso

Cada requisição consome créditos proporcionalmente ao número de tokens processados. Acompanhe seu uso em tempo real no painel. 1 crédito = R$ 0,001.

• 1 crédito = R$ 0,001
• Cada requisição debita créditos do seu saldo em tempo real
• Acompanhe no painel: uso diário, por modelo, total do período
• Exporte relatórios em CSV

Rate Limit e Isolamento

Cada provedor upstream (OpenAI, Anthropic, Maritaca, etc.) define seus próprios limites de taxa (RPM, TPM). O Apiário Dev repassa esses limites de forma transparente. Cada chave de API possui isolamento próprio — consulte os cabeçalhos de resposta para monitorar seu consumo.

Códigos de Erro

A API utiliza códigos HTTP padrão. Erros de validação retornam 422, créditos insuficientes retornam 402, e erros do provedor upstream são repassados com o formato apropriado (OpenAI, Anthropic ou Ollama).

Próximos passos

Explore o painel para gerenciar suas chaves, acompanhar uso e recarregar créditos.

Perguntas Frequentes

Dúvidas comuns sobre a API do Apiário Dev.