Chave de API Mimo: crie uma e faça uma requisição

Crie a chave em cinco etapas

Para obter uma chave de API da Mimo para este serviço, siga estes passos. Nada aqui precisa de cartão ou ligação telefônica. Pagamentos são aceitos apenas via cripto (USDT na TRC20, USDC na Base).

1. Cadastre-se. Use o Google ou registre-se com um endereço de e-mail e uma senha.
2. Abra a página da chave. Após o cadastro, vá para a página da chave de API. Sua chave é exibida lá.
3. Resgate o teste. Novos usuários podem resgatar $0,50 de crédito de teste com um clique nessa página. O crédito é válido por 7 dias, não precisa de cartão e é limitado a um por pessoa.
4. Copie a chave e armazene-a em algum lugar seguro, como um gerenciador de senhas ou uma variável de ambiente.
5. Envie uma requisição de teste com o comando curl na seção a seguir.

O serviço é uma API de texto hospedada e compatível com OpenAI. Ele executa um modelo de pesos abertos de um provedor independente, ajustado para responder sem recusas de conteúdo para uso adulto lícito. Não é a API oficial de nenhum provedor de modelo. Sua chave funciona com esse único modelo, cujo ID é uncensored, na URL base https://api.mimoapi.top/v1.

Teste a chave com uma requisição

Faça o teste em um terminal antes de conectar a chave ao seu app. Se falhar aqui, o problema é a chave ou a conta, e você não precisa procurar no seu próprio código.

Copyexport LLM_API_KEY="paste-your-key-here"

curl -i 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": "Write one sentence about keys."}],
    "max_tokens": 60
  }'

Um bom resultado é um status 200 e um corpo JSON com uma matriz choices. Os cabeçalhos contêm X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests e X-RateLimit-Limit-Concurrency. O cabeçalho de saldo é uma maneira rápida de ver o custo da requisição: execute-a duas vezes e compare. Se você quiser apenas confirmar a chave sem gastar nada, chame GET /v1/models com o mesmo cabeçalho.

A mesma requisição em Python, usando o pacote oficial da OpenAI:

Copyimport os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.mimoapi.top/v1",
    api_key=os.environ["LLM_API_KEY"],
)
resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write one sentence about keys."}],
    max_tokens=60,
)
print(resp.choices[0].message.content)

O que a chave de teste pode e não pode fazer

O crédito de teste é para avaliação, não para produção. Uma chave de teste permite 2 requisições simultâneas e 60 requisições por minuto, com duração de 7 dias. Uma chave completa, que você obtém ao adicionar crédito, permite 8 requisições simultâneas e 300 por minuto. Ambas compartilham o mesmo modelo, a mesma janela de contexto de 100.000 tokens e as mesmas funcionalidades: streaming via SSE, chamada de funções, modo JSON e os parâmetros de amostragem habituais.

O quanto $0,50 rende? A $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída, uma requisição com 1.000 tokens de entrada e 300 tokens de saída custa 1.000 x $0,15 / 1.000.000 = $0,00015 de entrada mais 300 x $0,50 / 1.000.000 = $0,00015 de saída, o que dá $0,0003. O crédito de teste cobre cerca de 1.666 requisições desse tamanho ($0,50 / $0,0003). Isso é suficiente para testar prompts, criar um protótipo e tentar streaming ou ferramentas.

Use o crédito de teste para medições. Escolha os cinco prompts que seu app enviará com mais frequência, execute cada um algumas vezes e registre a mudança no saldo. Você terminará a semana com um custo real por requisição e uma visão de como o modelo se comporta nos seus dados. Requisições com falha ou recusadas não são cobradas.

Mantenha a chave em segredo

Uma chave de API é uma senha que também gasta dinheiro. Qualquer pessoa que a tiver pode enviar requisições contra seu saldo. Algumas regras previnem a maioria dos vazamentos:

• Variáveis de ambiente, não arquivos de origem. Leia a chave com os.environ ou process.env. Para trabalho local, um arquivo .env listado no .gitignore é suficiente.
• Apenas no lado do servidor. Não chame a API de JavaScript no navegador ou de um aplicativo móvel, porque qualquer pessoa pode ler a chave na página ou no pacote do app. Coloque um pequeno servidor entre seu front-end e a API.
• Um local por chave. Mantenha a chave em um único repositório de segredos e copie-a para cada implantação a partir daí, para que você sempre saiba onde ela está.
• Nenhuma chave em chats, tickets ou capturas de tela. Ao pedir ajuda, compartilhe o X-Request-Id da resposta, não a chave.
• Substitua em caso de suspeita. Se você acha que uma chave foi exposta, pare de usá-la e entre em contato com o suporte para que ela seja substituída.

Observe também o cabeçalho X-Balance-USD. Um saldo que diminui quando seu aplicativo está ocioso é o primeiro sinal de que outra pessoa está usando sua chave.

Vá além do crédito de teste: recarregue e pague

Quando o teste acabar, adicione crédito. Qualquer valor inteiro de $20 a $500 funciona. Bônus são adicionados automaticamente: 5% a partir de $50, 10% a partir de $100 e 15% a partir de $200. Então, uma recarga de $100 dá $110 de crédito, e $200 dá $230. Você pode pagar com cripto (USDT em TRC20, USDC em Base).

Não há assinatura. Você paga por token a partir do seu saldo, e o crédito nunca expira, o que é adequado para projetos com tráfego irregular. A lista de preços completa está na página de preços. Os prompts enviados pela API não são usados para treinamento.

Uma primeira recarga sensata é de $20. Com a requisição de tamanho de chat usada anteriormente nesta página ($0,0003 cada), isso cobre cerca de 66.000 requisições. Verifique sua própria média após alguns dias e ajuste.

Solução de problemas de uma chave que não funciona

A maioria dos problemas com chaves tem causas simples.

• Erro de autenticação imediatamente. Um caractere foi perdido ou adicionado ao copiar. Procure um espaço à esquerda ou à direita, ou uma quebra de linha. Verifique se o cabeçalho é Authorization: Bearer seguido pela chave.
• Funciona no curl, não no seu aplicativo. O aplicativo provavelmente não está lendo a variável de ambiente. Imprima os quatro primeiros caracteres do valor que ele vê, não a chave inteira.
• Não encontrado. A URL base está errada. Deve ser https://api.mimoapi.top/v1, no subdomínio api. O guia de início rápido tem uma lista cliente a cliente.
• HTTP 429. O código concurrency significa muitas requisições ao mesmo tempo; rate_limited significa muitas por minuto. Chaves de teste atingem isso mais cedo (2 ao mesmo tempo, 60 por minuto). Um 429 com Retry-After: 5 significa sobrecarga breve; aguarde cinco segundos.
• Crédito de teste faltando. O crédito de teste é resgatado com um clique na página da chave e é um por pessoa. Ele expira após 7 dias.

Se nada disso resolver, colete o valor X-Request-Id de uma resposta falha e entre em contato com o suporte com ele. Esse ID permite rastrear o problema sem você enviar a chave.

O que construir primeiro

Com uma chave funcional, escolha um pequeno projeto que use as funcionalidades que você precisará mais tarde. Um loop de chat de linha de comando ensina histórico de mensagens. Um script que retorna um objeto JSON com response_format ensina saída estruturada. Uma função que o modelo pode chamar ensina o uso de ferramentas. Cada um leva menos de uma hora, e cada um é executado no saldo de teste. Se você está avaliando este serviço contra outros modelos hospedados, a comparação em Alternativas à API Mistral lista as perguntas que valem a pena fazer antes de se comprometer.

Mantenha o uso legal e adulto. O modelo é ajustado para responder sem recusas de conteúdo, e isso é um recurso para ficção, roleplay e pesquisa, não permissão para quebrar as regras: conteúdo sexual envolvendo menores de idade nunca é permitido.

Mais guias

• Preços da API Mimo: Taxas de Pagamento por Token Pré-pago
• URL Base da API Mimo e Como Configurar Clientes
• Alternativas à API Mistral: Comparando Opções de LLM Sem Censura