Saltar para o conteúdo principal

​
Introdução

Kimi é um serviço de chat AI fornecido pela Ace Data Cloud, baseado na série de grandes modelos de linguagem Kimi da Lua Negra. Através da API unificada da Ace Data Cloud, você pode usar cURL para chamar rapidamente o Kimi, realizando diálogos multi-turnos, prompts do sistema, saída em streaming, modo de saída JSON e outras funcionalidades.

​
Pré-requisitos

  • Ter uma conta na Ace Data Cloud e obter o Token da API
  • Ambiente de terminal com cURL instalado

​
Uso Básico

O endpoint principal para chamar a API Kimi é: 
POST https://api.acedata.cloud/kimi/chat/completions
Este exemplo usa o modelo kimi-k2.5.
Modelos disponíveis incluem: kimi-k2.5, kimi-k2-thinking-turbo, kimi-k2-thinking, kimi-k2-instruct-0905. Exemplo completo do comando cURL: 
curl -X POST https://api.acedata.cloud/kimi/chat/completions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model": "kimi-k2.5", "messages": [{"role": "user", "content": "你好，请介绍一下你自己"}], "max_tokens": 1024, "temperature": 0.7}'
Substitua YOUR_API_TOKEN pelo Token real que você obteve na plataforma Ace Data Cloud.

​
Exemplo de Resposta

Após uma chamada bem-sucedida, será retornado um dado em formato JSON, por exemplo: 
{
  "status": "success",
  "data": {
    ...
  }
}

​
Usando jq para Processar a Resposta

Recomenda-se usar a ferramenta jq para formatar a saída: 
curl -s -X POST https://api.acedata.cloud/kimi/chat/completions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model": "kimi-k2.5", "messages": [{"role": "user", "content": "你好，请介绍一下你自己"}], "max_tokens": 1024, "temperature": 0.7}' | jq .

​
Tratamento de Erros

Códigos de erro comuns:
Código de StatusDescrição
401Falha na autenticação, verifique o Token da API
403Saldo insuficiente ou acesso negado
429Limite de frequência de requisições excedido
500Erro interno do servidor

​
Próximos Passos