URL base da API Mimo e como configurar clientes

Os valores para copiar

Quem procura a URL base da API Mimo precisa de três valores; todo o resto é detalhe da ferramenta que você está configurando.

Configuração	Valor
URL base	https://api.mimoapi.top/v1
ID do modelo	uncensored
Cabeçalho de autenticação	Authorization: Bearer YOUR_KEY
Endpoint de chat	POST /v1/chat/completions
Lista de modelos	GET /v1/models

O serviço é compatível com OpenAI, então qualquer cliente que permita alterar a URL base e a chave de API da OpenAI funcionará. É uma API de texto hospedada que executa um modelo de pesos abertos de um provedor independente; não é a API oficial de nenhum fornecedor de modelo. Apenas texto: não há geração de imagem, áudio ou vídeo, nem embeddings nem fine-tuning, então clientes que esperam esses endpoints não os encontrarão. Se você ainda não tem uma chave, a página de chave leva um minuto.

URL base versus endpoint completo

A confusão mais comum é entre a URL base e a URL do endpoint. A URL base termina em /v1. O endpoint é a base mais um caminho. Os SDKs oficiais da OpenAI e a maioria das ferramentas baseadas neles unem os dois para você.

• URL base: https://api.mimoapi.top/v1
• Endpoint de chat: https://api.mimoapi.top/v1/chat/completions
• Endpoint de modelos: https://api.mimoapi.top/v1/models

Quando uma tela de configurações pede uma "URL base", "base da API", "endpoint" ou "host", leia o texto de exemplo. Se o texto de exemplo terminar em /v1, cole a URL base. Se terminar em /chat/completions, cole o endpoint de chat completo. Colar o endpoint completo em um campo que espera uma URL base produz /chat/completions/chat/completions, que não existe. Colar apenas o domínio nu em um campo que espera uma URL base produz /chat/completions sem /v1, o que falha da mesma forma.

Observe também o host. A API reside no subdomínio api. O domínio principal do site serve as páginas da web, então uma solicitação a ele com um caminho de API não alcançará o modelo.

Python e Node

Com os SDKs oficiais, você define a URL base uma vez ao criar o cliente. Instale com pip install openai ou npm install openai.

Copyfrom openai import OpenAI

client = OpenAI(
    base_url="https://api.mimoapi.top/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Name three uses for a base URL."}],
    max_tokens=150,
)
print(resp.choices[0].message.content)

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.mimoapi.top/v1",
  apiKey: process.env.LLM_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Name three uses for a base URL." }],
  max_tokens: 150,
});
console.log(resp.choices[0].message.content);

Os SDKs OpenAI para Python e Node também leem as variáveis de ambiente OPENAI_BASE_URL e OPENAI_API_KEY quando você não passa valores no código. Isso permite redirecionar um script existente sem editá-lo: exporte as duas variáveis e o script falará com esta API. Verifique se o script não tem um modelo codificado, como um nome de GPT; substitua-o por uncensored.

curl para um teste rápido

Uma chamada HTTP simples remove todas as outras variáveis, sendo a melhor primeira verificação. O primeiro comando lista modelos e confirma a chave. O segundo envia uma solicitação de chat.

Copyexport LLM_API_KEY="YOUR_KEY"

curl -s https://api.mimoapi.top/v1/models \
  -H "Authorization: Bearer $LLM_API_KEY"

curl -s https://api.mimoapi.top/v1/chat/completions \
  -H "Authorization: Bearer $LLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":20}' -i

A flag -i imprime os cabeçalhos de resposta. Procure por X-Request-Id (cite-o se entrar em contato com o suporte), X-Balance-USD (seu crédito restante) e os dois cabeçalhos de limite de requisições, X-RateLimit-Limit-Requests e X-RateLimit-Limit-Concurrency. Para streaming, adicione "stream": true ao corpo e -N ao curl para que a saída não seja bufferizada. O quickstart de cinco minutos percorre streaming e chamada de funções depois disso.

LangChain, interfaces de chat e outras ferramentas

Ferramentas de terceiros usam seus próprios rótulos, mas todas precisam dos mesmos três valores. Alguns padrões que você verá:

• LangChain (Python): ChatOpenAI(model="uncensored", base_url="https://api.mimoapi.top/v1", api_key="YOUR_KEY"). A mesma classe funciona para qualquer servidor compatível com OpenAI.
• SillyTavern e interfaces de roleplay similares: escolha uma fonte de chat personalizada ou genérica compatível com OpenAI, cole a URL base, adicione a chave e digite uncensored como o nome do modelo se a lista não for preenchida automaticamente.
• Open WebUI e outras interfaces de chat auto-hospedadas: adicione uma conexão compatível com OpenAI nas configurações, usando a mesma URL base e chave.
• Extensões e scripts de editor: procure por "endpoint OpenAI personalizado" ou "substituir URL base" nas configurações da extensão.

Os nomes dos menus de cada ferramenta mudam entre versões, então confie no propósito do campo em vez do rótulo exato. Se uma ferramenta insistir em verificar a chave contra um provedor fixo, ela não é compatível com endpoints personalizados e uma ferramenta diferente é a solução.

Quando uma ferramenta oferece um menu suspenso de modelos, geralmente o preenche chamando GET /v1/models. Se o menu suspenso permanecer vazio, digite o ID do modelo manualmente. Se a ferramenta recusar nomes de modelos desconhecidos, procure uma opção rotulada "modelo personalizado".

Corrigindo os erros de configuração comuns

Quando uma requisição falha, o código de status e a URL exata restringem a causa rapidamente. Siga esta lista.

1. Erro de autenticação. A chave está faltando, truncada ou tem um espaço ou nova linha no final. Cole-a novamente e certifique-se de que o cabeçalho seja Bearer, um espaço e depois a chave.
2. Não encontrado. O caminho está errado. Imprima a URL final que seu cliente constrói. Deve ser exatamente https://api.mimoapi.top/v1/chat/completions. Procure por um /v1 faltando, um caminho duplicado ou o host errado.
3. Modelo desconhecido. Um nome de modelo restante de outro provedor. Defina o modelo como uncensored.
4. HTTP 429 com rate_limited ou concurrency. Você está acima de 300 requisições por minuto ou 8 ao mesmo tempo (60 e 2 em uma chave de teste). Diminua a velocidade ou faça fila nas requisições. Um 429 com um cabeçalho Retry-After: 5 significa sobrecarga temporária; aguarde cinco segundos e tente novamente.
5. Requisição muito grande. O limite do corpo é 8 MB e a janela de contexto é de 100.000 tokens para prompt mais conclusão. Reduza o histórico.
6. Funciona no curl, falha no navegador. Chamar a API diretamente do JavaScript do front-end expõe sua chave para todos os visitantes. Encaminhe as chamadas através do seu próprio servidor.

Nunca coloque a chave em um repositório público ou em um pacote do lado do cliente. Armazene-a em uma variável de ambiente e mantenha-a fora de capturas de tela e tickets de suporte.

Próximos passos após a primeira chamada bem-sucedida

Uma vez que a URL base funcione, algumas configurações valem a pena conhecer. O streaming via SSE é ativado com stream: true. A chamada de funções usa tools e tool_choice, com os resultados enviados de volta como mensagens role: "tool". O modo JSON é response_format: {"type": "json_object"}. Controles de amostragem como temperature, top_p, stop, seed e as penalidades são passados diretamente.

Em termos de custo, você paga $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída a partir de crédito pré-pago; a página de preços lista os tamanhos de recarga e bônus. O modelo é ajustado para responder sem recusas de conteúdo para uso adulto legal, e conteúdo sexual envolvendo menores de idade nunca é permitido. Os prompts não são usados para treinamento.

Mais guias

• Preços da API Mimo: Taxas Pré-pagas por Token
• Chave da API Mimo: Crie uma e Faça uma Requisição
• Alternativas à API Mistral: Comparando Opções de LLM Sem Censura