Przejdź do głównej treści

​
Wprowadzenie

Kimi to usługa czatu AI oferowana przez Ace Data Cloud, oparta na dużym modelu językowym serii Kimi od Moon’s Dark Side. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko zintegrować Kimi za pomocą JavaScript, realizując funkcje takie jak wieloetapowa konwersacja, systemowe promptowanie, strumieniowe wyjście oraz tryb wyjścia JSON.

​
Wymagania wstępne

  • Konto w Ace Data Cloud oraz uzyskany token API
  • Node.js 18+ lub nowoczesne środowisko przeglądarkowe

​
Podstawowe użycie

Główny endpoint API Kimi to: 
POST https://api.acedata.cloud/kimi/chat/completions
W tym przykładzie używamy modelu kimi-k2.5. Dostępne modele to: kimi-k2.5, kimi-k2-thinking-turbo, kimi-k2-thinking, kimi-k2-instruct-0905. Pełny przykład kodu JavaScript: 
const response = await fetch("https://api.acedata.cloud/kimi/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "kimi-k2.5",
  "messages": [
    {
      "role": "user",
      "content": "你好，请介绍一下你自己"
    }
  ],
  "max_tokens": 1024,
  "temperature": 0.7
}),
});

const result = await response.json();
console.log(result);
Zamień YOUR_API_TOKEN na rzeczywisty token uzyskany na platformie Ace Data Cloud.

​
Obsługa odpowiedzi

Zaleca się sprawdzenie statusu odpowiedzi i obsługę błędów: 
if (response.ok) {
  const result = await response.json();
  console.log("Wywołanie zakończone sukcesem:", result);
} else {
  console.error(`Wywołanie nie powiodło się, kod statusu: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

​
Opakowanie w Node.js

Rekomendowane jest opakowanie w funkcję wielokrotnego użytku: 
async function callKimi(data) {
  const response = await fetch("https://api.acedata.cloud/kimi/chat/completions", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`Błąd API: ${response.status}`);
  return response.json();
}

​
Obsługa błędów

Typowe kody błędów:
Kod statusuOpis
401Nieautoryzowany, sprawdź token API
403Niewystarczające środki lub brak dostępu
429Przekroczono limit częstotliwości zapytań
500Błąd wewnętrzny serwera

​
Kolejne kroki