kimiapikey.comGuia
URL base da API Moonshot: aponte seu código para outro lugar
O URL base da API moonshot é apenas uma string no seu cliente estilo OpenAI, e alterá-la é como direcionar o mesmo código para um provedor diferente. Esta página mostra onde essa string fica no Python, Node, curl e ferramentas comuns, e como direcioná-la para um endpoint alternativo.
Atualizado


Pontos principais
- O URL base é uma única configuração; o corpo da requisição permanece no formato de chat OpenAI.
- Altere três coisas ao trocar: URL base, chave de API e ID do modelo.
- Nosso endpoint é https://api.kimiapikey.com/v1 e o ID do modelo é uncensored.
- É um modelo hospedado independentemente, não o serviço oficial da Moonshot, então reteste seus prompts.
O que uma URL base realmente faz
Clientes compatíveis com OpenAI constroem cada requisição a partir de duas partes: um URL base e um caminho. O SDK os une, então uma chamada para chat.completions.create se torna um POST para <base_url>/chat/completions. Provedores que seguem este formato, incluindo a Moonshot, publicam seu próprio URL base em sua documentação. Consulte-o lá em vez de copiá-lo de uma postagem de fórum, pois é o único valor que você não pode adivinhar.
Portanto, trocar de provedor requer apenas três edições:
- O URL base, que decide para onde a requisição vai.
- A chave de API, que é emitida por provedor e só funciona nos servidores desse provedor.
- O ID do modelo, porque cada provedor nomeia seus modelos de forma diferente.
Mensagens, papéis, streaming, ferramentas e modo JSON mantêm a mesma estrutura, por isso a migração é rápida. Qualquer coisa que dependa de um recurso específico do provedor, como uma ferramenta de busca na web integrada, precisará de tratamento separado.
Também ajuda manter os três valores juntos em um bloco de configuração ou um arquivo de ambiente por provedor. Quando o URL base, a chave e o ID do modelo ficam lado a lado, voltar atrás é uma alteração de uma linha, e você evita o estado de migração parcial onde uma nova chave é pareada com um endereço antigo.
Python: o pacote openai
Em Python, você define o URL base ao criar o cliente. Este exemplo se conecta ao endpoint deste site:
from openai import OpenAI
client = OpenAI(
base_url="https://api.kimiapikey.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Explain a base URL in one sentence."}],
)
print(resp.choices[0].message.content)
Se preferir manter o código livre de configurações, use o ambiente. O SDK lê OPENAI_BASE_URL e OPENAI_API_KEY quando você chama OpenAI() sem argumentos, então uma implantação pode trocar de provedor sem alterar o código. Observe que isso também significa que uma variável restante no seu shell pode substituir um valor que você escreveu no arquivo.
Node e curl
O pacote JavaScript oficial usa o mesmo nome de opção, escrito em camel case:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.kimiapikey.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Hello" }],
stream: false,
});
console.log(resp.choices[0].message.content);
Sem nenhum SDK, o URL base é simplesmente o início do endereço:
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'
O mesmo endpoint também aceita POST /v1/responses, e GET /v1/models lista o que ele serve. A autenticação é um token Bearer no cabeçalho Authorization em todos os casos.
Editores e interfaces de chat
Ferramentas GUI expõem o URL base sob rótulos diferentes: "API base", "Substituir URL Base OpenAI", "Endpoint personalizado" ou "URL do provedor". O valor que você cola é a mesma string do código acima, terminando em /v1. Não cole o endereço completo /chat/completions a menos que a ferramenta indique que deseja a URL completa.
Após salvar, adicione o ID do modelo manualmente se a ferramenta não buscar uma lista. Alguns editores validam a chave contra um provedor fixo e recusam valores personalizados, caso em que procure uma configuração que ative o modo personalizado ou compatível com OpenAI primeiro. O artigo sobre usando uma chave de API estilo Kimi no Cursor detalha uma dessas ferramentas.
O que muda ao trocar de provedor
Um formato correspondente não significa comportamento correspondente. Antes de mover o tráfego de produção, verifique estes pontos um por um:
- Estilo de saída. Um modelo diferente escreve de forma diferente. Execute seus prompts reais, não um exemplo de teste.
- Tamanho do contexto. O endpoint aqui tem uma janela de 100.000 tokens para prompt mais conclusão. Se sua configuração atual envia prompts mais longos, corte-os primeiro.
- Limites. Uma chave completa permite 8 requisições simultâneas e 300 por minuto. Acima de qualquer um dos limites, você recebe HTTP 429, com
rate_limitedouconcurrencycomo o código. - Recursos. Streaming via SSE, chamada de funções e modo JSON são suportados. Geração de imagem, áudio e vídeo, embeddings e ajuste fino não são; esta é uma API apenas de texto.
- Nome. O serviço executa um único modelo de pesos abertos escolhido para responder sem recusas de conteúdo para uso adulto lícito. Não é a API oficial da Moonshot nem um roteador entre fornecedores.
Uma maneira neutra de comparar é registrar os mesmos dez prompts através de ambos os endpoints e ler as respostas lado a lado. Isso leva minutos e economiza palpites.
Erros de URL base e como aparecem
A maioria das falhas após uma troca vem do endereço, não da chave. Aqui está como cada erro se manifesta e como repará-lo.
| Erro | Sintoma | Correção |
|---|---|---|
Host apenas, sem /v1 | 404 em todas as chamadas | Adicione /v1 ao final |
| Caminho completo colado | 404 com um caminho duplicado no erro | Corte o endereço de volta para /v1 |
| Barra final mais junção de caminho manual | Barra dupla na URL | Deixe o SDK unir o caminho |
| Chave antiga, URL novo | 401 | Use a chave emitida pelo novo provedor |
| URL antigo, chave nova | 401 do provedor antigo | Pesquise no repositório e no shell pelo endereço antigo |
http:// em vez de https:// | Erro de redirecionamento ou conexão | Use https em tudo |
Uma maneira rápida de encontrar resíduos é pesquisar seu projeto e configurações de implantação pelo nome de host antigo. Procure em arquivos .env, variáveis de CI, arquivos Docker compose e configurações de editor, já que uma única cópia esquecida é suficiente para enviar algum tráfego para o provedor antigo.
Streaming e ferramentas após a troca
Defina stream: true e a resposta chega como eventos enviados pelo servidor, com uso de token relatado no final. A chamada de ferramentas usa os campos usuais tools e tool_choice, com tool_calls em streaming e resultados enviados de volta como mensagens com role: "tool". Se seu código já lida com isso para o provedor antigo, deve continuar funcionando; confirme executando uma chamada em streaming e uma chamada de ferramenta antes de migrar totalmente. Lembre-se de que uma solicitação em streaming mantém seu slot de concorrência até o fim do stream.
Verificação de custo antes de trocar
A cobrança aqui é por token: $0,15 por 1M tokens de entrada e $0,50 por 1M tokens de saída, a partir de crédito pré-pago, sem assinatura. Requisições falhas ou recusadas não são cobradas, e o crédito não expira. Para as taxas de outro provedor, verifique a página de preços atual deles, pois elas mudam.
Um exemplo prático. Suponha que uma solicitação tenha 2.000 tokens de entrada e 500 tokens de saída:
- Entrada: 2.000 / 1.000.000 x $0,15 = $0,0003
- Saída: 500 / 1.000.000 x $0,50 = $0,00025
- Total: $0,00055 por solicitação, então 1.000 solicitações custam $0,55
A menor recarga é de $20, e recargas maiores oferecem um bônus: +5% a partir de $50, +10% a partir de $100 e +15% a partir de $200. Cripto (USDT em TRC20, USDC em Base) é aceito. Detalhes completos estão na página de preços, e a análise focada em Kimi está em preços da chave de API Kimi.
Obtenha uma chave e execute a primeira chamada
Faça login com Google ou com e-mail e senha, depois acesse a página de chave de API. Novos usuários podem reivindicar $0,50 de crédito de teste com um clique, um por pessoa, válido por 7 dias e sem necessidade de cartão. Chaves de teste são limitadas a 2 requisições simultâneas e 60 por minuto, o que é suficiente para uma execução de teste.
Cole a chave no snippet Python acima, execute-o e confirme que você recebe texto de volta. A página de documentação lista todos os parâmetros, e os cabeçalhos de resposta X-Request-Id e X-Balance-USD ajudam na depuração e no acompanhamento do saldo. Os prompts enviados ao serviço não são usados para treinamento.
Mais guias
- Chave de API do Kimi não funciona: causas, correções e fallback
- Use uma Chave de API Estilo Kimi no Cursor: Guia de Configuração
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 respostas 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, nós 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
Preciso alterar meu código ao mudar a URL base?
Normalmente apenas três valores: URL base, chave de API e ID do modelo. O formato da mensagem, streaming e chamada de ferramentas permanecem os mesmos desde que o novo provedor os suporte.
A URL base deve terminar com /v1?
Sim para este endpoint: https://api.kimiapikey.com/v1. O SDK adiciona /chat/completions ele mesmo, então não o inclua.
Esta é a API oficial da Moonshot?
Não. É um modelo de pesos abertos hospedado independentemente por trás de uma API compatível com OpenAI. Não é o serviço da Moonshot nem um roteador entre fornecedores.
Onde encontro o ID do modelo?
Chame GET /v1/models com sua chave. Neste endpoint, o ID do modelo é uncensored.
Sua chave está a um formulário de distância
Crie uma conta, copie a chave, altere a URL base. Essa é toda a configuração.