Documentação da API

A Mangaba AaaS oferece uma API compatível com OpenAI para acessar múltiplos modelos de IA. Use qualquer SDK OpenAI com nossa plataforma.

Autenticação

Use Bearer Token com sua API Key em todas as requisições:

curl -X POST https://mangaba-api.up.railway.app/api/v1/chat/completions \
  -H "Authorization: Bearer mk-sua-api-key-aqui" \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/gpt-4o-mini", "messages": [{"role": "user", "content": "Olá!"}]}'

Providers Suportados

A Mangaba AaaS roteia suas requisições para o melhor provider disponível:

Chat Completions

Parâmetros

Exemplo Python

from mangaba import MangabaAI

client = MangabaAI(api_key="mk-sua-api-key")

response = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[
        {"role": "system", "content": "Você é um assistente útil."},
        {"role": "user", "content": "Explique Python em 3 frases."}
    ],
    temperature=0.7,
    max_tokens=500
)

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

# Informações de custo (exclusivo Mangaba)
print(f"Custo: ${response.mangaba_usage['total_cost_usd']:.6f}")
print(f"Provider: {response.mangaba_usage['provider_name']}")

Exemplo JavaScript

import MangabaAI from 'mangaba';

const client = new MangabaAI({ apiKey: 'mk-sua-api-key' });

const response = await client.chat.completions.create({
    model: 'openai/gpt-4o-mini',
    messages: [
        { role: 'system', content: 'Você é um assistente útil.' },
        { role: 'user', content: 'Explique JavaScript em 3 frases.' }
    ]
});

console.log(response.choices[0].message.content);
console.log('Custo:', response.mangaba_usage?.total_cost_usd);

Exemplo Go

package main

import (
    "context"
    "fmt"
    "github.com/mangaba-ai/mangaba-go"
)

func main() {
    client := mangaba.NewClient("mk-sua-api-key")
    
    resp, _ := client.Chat.Completions.Create(context.Background(), mangaba.ChatRequest{
        Model: "openai/gpt-4o-mini",
        Messages: []mangaba.Message{
            {Role: "user", Content: "Olá! Como funciona Go?"},
        },
    })
    
    fmt.Println(resp.Choices[0].Message.Content)
}

Exemplo cURL/REST

curl https://mangaba-api.up.railway.app/api/v1/chat/completions \
  -H "Authorization: Bearer mk-sua-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [{"role": "user", "content": "Olá!"}]
  }'

Listar Modelos

Retorna todos os modelos disponíveis com informações de preço.

curl https://mangaba-api.up.railway.app/api/v1/models

Modelos Disponíveis

Monitorar Uso

Retorna estatísticas de uso e custos da sua API key.

curl https://mangaba-api.up.railway.app/api/v1/usage \
  -H "Authorization: Bearer mk-sua-api-key"

Resposta

{
  "key": {
    "name": "Chave Principal",
    "prefix": "mk-abc1...xyz9",
    "total_requests": 1542,
    "total_tokens_input": 125000,
    "total_tokens_output": 87000,
    "total_cost_usd": 4.75,
    "cost_this_month_usd": 2.30,
    "monthly_budget_usd": 50.00
  },
  "account": {
    "plan": "pro",
    "credits_balance_usd": 45.25,
    "credits_used_this_month_usd": 4.75
  }
}

Testar API Key

Valida sua API key e retorna informações do usuário e limites.

curl -X POST https://mangaba-api.up.railway.app/api/v1/test \
  -H "Authorization: Bearer mk-sua-api-key"

Health Check

Verifica status da API e provider ativo.

curl https://mangaba-api.up.railway.app/api/v1/health

Streaming

Use stream: true para receber a resposta em tempo real via SSE:

from mangaba import MangabaAI

client = MangabaAI(api_key="mk-sua-api-key")

stream = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[{"role": "user", "content": "Conte uma história curta"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Códigos de Erro

Rate Limits

Os limites variam de acordo com seu plano:

SDKs Oficiais Mangaba

Use nossos SDKs oficiais para uma integração simplificada:

pip install mangaba

from mangaba import MangabaAI
client = MangabaAI(api_key="mk-...")

npm install mangaba

import MangabaAI from 'mangaba';
const client = new MangabaAI({ apiKey: 'mk-...' });