Sua primeira chamada em 5 minutos

1. Crie uma conta

Abra uma conta gratuita no MandAPI. O cadastro pode ser feito no painel; assim que a conta estiver ativa, você poderá gerar chaves e consultar o catálogo de modelos.

2. Crie uma API Key

No painel, gere uma API Key. A chave completa é exibida uma única vez — guarde-a em uma variável de ambiente e não a compartilhe. Veja o passo a passo em Chaves de API.

3. Escolha um modelo

Use um modelo do catálogo. Hoje o modelo disponível e verificado em produção é deepseek-v4-flash (compatível com o formato OpenAI).

A lista real e atualizada pode ser consultada a qualquer momento via GET /v1/models ou no painel. Consulte Modelos para detalhes.

4. Faça a primeira requisição

Envie uma chamada para o endpoint de chat. O Base URL é:

Exemplo com curl (compatível com OpenAI):

curl https://api.mandapi.com/v1/chat/completions \
  -H "Authorization: Bearer $MANDAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      { "role": "user", "content": "Olá, MandAPI. Me explique o que você faz em uma frase." }
    ],
    "temperature": 0.7
  }'

Resposta de sucesso (formato OpenAI):

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "choices": [
    { "index": 0, "message": { "role": "assistant", "content": "..." }, "finish_reason": "stop" }
  ],
  "usage": { "prompt_tokens": 87, "completion_tokens": 19, "total_tokens": 106 }
}

Exemplos em Python e JavaScript

Os exemplos abaixo usam os SDKs oficiais da OpenAI apontando para o Base URL da MandAPI. São OpenAI-compatible TO VERIFY — a chamada de ponta a ponta com os pacotes oficiais openai ainda está em verificação. O formato e o endpoint, no entanto, são idênticos aos da API OpenAI.

Python:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.mandapi.com/v1",
    api_key=os.environ["MANDAPI_API_KEY"],
)

resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Olá, MandAPI."}],
)
print(resp.choices[0].message.content)

JavaScript (Node.js):

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.mandapi.com/v1",
  apiKey: process.env.MANDAPI_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [{ role: "user", content: "Olá, MandAPI." }],
});
console.log(resp.choices[0].message.content);

Streaming e tool calling

O gateway suporta streaming (SSE, com stream: true) e chamada de ferramentas (function calling), ambos verificados em produção com deepseek-v4-flash.