PT ▾
Obter chave de API

kimiapikey.comGuia

Chave de API Kimi não funciona: causas, correções e fallback

Se o erro de chave de API Kimi não funcionar aparecer como 401, 404 ou 429, a causa é quase sempre uma das cinco coisas: URL base errada, chave incompatível, sem saldo, um limite de taxa ou um nome de modelo que o endpoint não conhece. Verifique-os nesta ordem.

Atualizado

Uma chave inserida em uma fechadura enquanto um caminho de luz verde leva a uma segunda fechadura aberta, simbolizando um endpoint de API de fallback
Ilustração isométrica de um editor de código conectado por um cabo luminoso a um servidor de API

Pontos principais

  • Uma chave só funciona contra o provedor que a emitiu, então a base URL e a chave devem vir do mesmo painel.
  • 401 significa que a chave foi rejeitada, 404 geralmente significa um caminho incorreto, 429 significa que você atingiu um limite ou o serviço está ocupado.
  • Imprima o código de status e o corpo da resposta antes de alterar qualquer outra coisa.
  • Mantenha um segundo endpoint compatível com OpenAI configurado para que uma única falha não pare seu aplicativo.

Leia o código de status primeiro

Antes de regenerar qualquer coisa, observe o que o servidor realmente disse. A maioria dos clientes estilo OpenAI oculta o corpo atrás de uma exceção genérica. Imprima tanto o status quanto o texto.

curl -i https://api.kimiapikey.com/v1/models \
  -H "Authorization: Bearer $YOUR_KEY"

A primeira linha da resposta indica onde procurar:

CódigoSignificado usualComece com
401Chave rejeitadaCópia da chave, chave e URL base de provedores diferentes
404Caminho ou modelo não encontradoFaltando /v1, caminho duplicado, ID de modelo errado
400Corpo da requisição inválidoNomes de parâmetros, formato da mensagem, tamanho do corpo
429Limite atingido ou serviço ocupadoTaxa de requisições, chamadas paralelas, tempo de nova tentativa
5xxProblema no lado do servidorTente novamente com backoff, depois mude para um fallback

Se você não receber nenhuma resposta HTTP (um tempo limite ou erro de DNS), o problema é a rede ou o nome de host que você digitou, não a chave.

Base URL e chave devem estar juntas

Esta é a causa mais comum de uma chave nova falhar. Chaves são emitidas por provedor. Uma chave de um painel é simplesmente desconhecida pelos servidores de outro provedor, então ela retorna 401 mesmo que a chave seja perfeitamente válida onde foi emitida.

Verifique estes pontos:

  • A chave e a base URL vêm da mesma página de conta. Se você copiou a chave de um provedor e deixou uma base URL antiga na sua configuração, a requisição vai para o lugar errado.
  • Variáveis de ambiente não estão ocultando seu código. O SDK OpenAI lê OPENAI_API_KEY e OPENAI_BASE_URL quando você não os passa explicitamente, então uma variável de shell desatualizada pode substituir o que você escreveu no arquivo.
  • Não há espaço em branco ou nova linha no final da chave. Uma nova linha final ao copiar e colar é uma causa clássica de 401.
  • O cabeçalho é exatamente Authorization: Bearer <key>. Algumas ferramentas esperam a chave em um cabeçalho diferente e precisam que o modo compatível com OpenAI seja ativado.

Editores e interfaces de chat adicionam mais uma armadilha. Muitos deles mantêm um campo separado para a "base URL OpenAI" e um botão separado que o ativa. Se a alternância estiver desativada, o aplicativo continua silenciosamente chamando o host padrão com sua nova chave, e você recebe um 401 que parece uma chave inválida. Salve as configurações, reinicie o aplicativo se ele as armazenar em cache e envie uma mensagem de teste curta antes de testar qualquer coisa mais complexa.

A base URL deve terminar em /v1, não no host e não em /v1/chat/completions. O SDK anexa o restante. Uma URL que já inclui o caminho completo acaba resultando em um caminho duplicado e um 404.

Acesso regional, proxies e redes corporativas

Às vezes a chave está correta e a requisição nunca chega ao servidor certo. A disponibilidade do provedor pode depender de onde você se conecta, e uma VPN, um proxy corporativo ou uma regra de firewall podem bloquear ou reescrever o tráfego. Consulte a documentação ou a página de status do próprio provedor para ver as regiões suportadas e não assuma que as regras são as mesmas para outro serviço.

Um teste rápido de isolamento: execute o mesmo comando curl em uma rede diferente, como um hotspot de celular. Se funcionar lá, a chave está boa e sua rede é a causa. Se o proxy definir HTTPS_PROXY, verifique se sua biblioteca HTTP realmente respeita isso; algumas ferramentas ignoram e falham com um erro de conexão.

Saldo, cota e como se apresenta um limite de requisições

Uma chave pode ser válida e ainda assim recusar requisições porque a conta não tem crédito restante ou uma cota foi esgotada. Verifique o painel antes de depurar o código. Se você nunca recarregou, lembre-se de que as cotas gratuitas geralmente são pequenas e de curta duração.

Um 429 é uma história diferente. Significa que o servidor está limitando a taxa, não que a chave é ruim. No endpoint descrito neste site, uma chave completa permite 8 requisições simultâneas e 300 requisições por minuto, e uma chave de teste permite 2 simultâneas e 60 por minuto. Quando você excede os limites, a API retorna HTTP 429 com o código de erro rate_limited (muitas por minuto) ou concurrency (muitas de uma vez). Sobrecarga temporária também retorna 429, com o cabeçalho Retry-After: 5.

Dois hábitos corrigem a maioria desses casos. Honre Retry-After quando presente, e limite seus workers paralelos ao limite de concorrência. Uma solicitação streaming mantém sua conexão até o fim do streaming, então um fluxo travado conta contra você por mais tempo do que você espera.

Nome do modelo, parâmetros e tamanho do corpo

Um 404 ou um 400 com uma chave válida geralmente aponta para a própria requisição. Três coisas para verificar:

  1. ID do modelo. Cada provedor tem seus próprios nomes de modelo. Pergunte ao endpoint o que ele serve com GET /v1/models e copie o ID da resposta. Neste site, o ID é uncensored.
  2. Parâmetros. Nomes como max_tokens, temperature e response_format são padrão, mas um provedor pode aceitar apenas um subconjunto. Remova campos opcionais até que a requisição passe, depois adicione-os de volta um por um.
  3. Tamanho. Prompts muito grandes podem falhar nos limites do corpo antes que o modelo os veja. Aqui, o corpo máximo é 8 MB e a janela de contexto é de 100.000 tokens para prompt e conclusão juntos.

O streaming é outro lugar onde uma chave funcionando parece quebrada. Se uma requisição tiver sucesso sem stream: true e falhar com ela, a causa é frequentemente um proxy que armazena em buffer ou corta eventos enviados pelo servidor, não o endpoint. Desative o streaming para confirmar, e depois verifique as configurações do proxy.

Se você alterou apenas o nome do modelo e a chamada falhou, volte para o nome antigo para confirmar que o resto da sua configuração está bom.

Mantenha um endpoint de fallback pronto

Mesmo um provedor saudável tem horas ruins. Se seu produto depende de uma única chave, uma única falha se torna sua interrupção. Como o formato de solicitação OpenAI é compartilhado, você pode manter um segundo endpoint configurado e alternar com algumas linhas.

O endpoint neste site é compatível com OpenAI, então ele se encaixa como um segundo provedor. É um modelo de pesos abertos hospedado independentemente, não o serviço oficial da Moonshot, e ele responderá de forma diferente de um modelo Kimi, então teste seus prompts antes de confiar nele. Aqui está um pequeno wrapper que tenta o principal primeiro e faz fallback em erros:

import os
from openai import OpenAI

primary = OpenAI(base_url=os.environ["PRIMARY_BASE_URL"],
                 api_key=os.environ["PRIMARY_KEY"])
fallback = OpenAI(base_url="https://api.kimiapikey.com/v1",
                  api_key=os.environ["FALLBACK_KEY"])

def ask(messages):
    try:
        r = primary.chat.completions.create(
            model=os.environ["PRIMARY_MODEL"], messages=messages, timeout=30)
    except Exception as e:
        print("primary failed:", e)
        r = fallback.chat.completions.create(
            model="uncensored", messages=messages, timeout=60)
    return r.choices[0].message.content

print(ask([{"role": "user", "content": "Say hi in five words."}]))

O preço é pagamento por uso: $0,15 por 1M tokens de entrada e $0,50 por 1M tokens de saída a partir de crédito pré-pago que nunca expira. Requisições falhas ou recusadas não são cobradas, então um fallback que raramente é executado custa quase nada para manter. Recargas começam em $20; veja preços para os níveis de bônus.

Teste o fallback em dois minutos

Novos usuários podem reivindicar $0,50 de crédito de teste com um clique na página da chave de API após entrar. Não precisa de cartão e é válido por 7 dias, o suficiente para executar seus prompts reais no endpoint uma vez. Depois, execute o teste de fumaça abaixo.

curl https://api.kimiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $FALLBACK_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'

Verifique o cabeçalho de resposta X-Balance-USD para ver seu crédito restante. A referência completa da requisição está na documentação. Se você está integrando isso a um editor, o guia existente sobre como usar uma chave de API estilo Kimi no Cursor mostra onde o campo da URL base fica, e a visão geral da chave de API Kimi explica como este endpoint se relaciona com o modelo que você estava usando.

Perguntas frequentes

O modelo é o mesmo que o Kimi oficial da Moonshot?
Não, hospedamos um modelo de pesos abertos que é ajustado para ser sem censura. Não é GPT, Claude, Gemini, Grok, DeepSeek ou qualquer outro modelo de fornecedor. É um modelo distinto executado em nossos próprios servidores.

Você treina com meus dados?
Não. Seus prompts e completions não são usados para treinamento. Valorizamos privacidade e transparência, então seus dados permanecem seus.

Quais são os limites de requisições?
Você está limitado a 300 requisições por minuto por chave. O tamanho máximo do corpo da requisição é 8 MB. Esses limites são projetados para garantir desempenho estável para todos os usuários.

Qual é a política de conteúdo?
O modelo é sem censura em relação a temas adultos, controversos e criativos. No entanto, bloqueamos conteúdo sexual envolvendo menores. Este é um limite rígido que sempre se aplica, independentemente do seu nível de assinatura.

Perguntas e respostas

Por que minha nova chave retorna 401 imediatamente?

As razões mais comuns são uma chave enviada para a URL base de um provedor diferente, um espaço ou nova linha solta na chave copiada, ou uma variável de ambiente substituindo seu código. Teste com curl para descartar seu SDK.

Um 429 é o mesmo que uma chave inválida?

Não. Um 429 significa que você atingiu um limite de taxa, um limite de concorrência ou uma sobrecarga temporária. A chave é válida. Aguarde o valor Retry-After e reduza suas requisições simultâneas.

As requisições falhas custam dinheiro aqui?

Não. Requisições falhas ou recusadas não são cobradas neste endpoint, então tentar novamente uma chamada com erro não drena seu crédito.

Posso usar este endpoint como uma substituição pronta para um modelo Kimi?

Ele usa o mesmo formato de solicitação OpenAI, então a alteração de código é uma URL base, uma chave e o ID do modelo uncensored. O modelo subjacente é diferente, então as respostas não corresponderão; teste seus prompts primeiro.

Sua chave está a um formulário de distância

Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.

Obter chave de APILer a documentação