Kimi JavaScript швидкий старт

Вступ

Kimi — це AI чат-сервіс від Ace Data Cloud, великий мовний модель серії Kimi від Moon’s Dark Side. Через уніфікований API Ace Data Cloud ви можете швидко інтегрувати Kimi за допомогою JavaScript, реалізуючи багатокрокові діалоги, системні підказки, потоковий вивід, режим виводу JSON та інші функції.

Передумови

Мати акаунт Ace Data Cloud та отримати API Token
Node.js 18+ або сучасне браузерне середовище

Базове використання

Головна кінцева точка виклику API Kimi:

POST https://api.acedata.cloud/kimi/chat/completions

У цьому прикладі використовується модель kimi-k2.5.
Доступні моделі: kimi-k2.5, kimi-k2-thinking-turbo, kimi-k2-thinking, kimi-k2-instruct-0905. Повний приклад коду 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);

Будь ласка, замініть YOUR_API_TOKEN на фактичний токен, отриманий на платформі Ace Data Cloud.

Обробка відповіді

Рекомендується перевіряти статус відповіді та обробляти помилки:

if (response.ok) {
  const result = await response.json();
  console.log("Виклик успішний:", result);
} else {
  console.error(`Виклик не вдався, код статусу: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

Обгортка для Node.js

Рекомендується створити повторно використовувану функцію:

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(`API error: ${response.status}`);
  return response.json();
}

Обробка помилок

Поширені коди помилок:

Код статусу	Опис
401	Помилка аутентифікації, перевірте API Token
403	Недостатньо коштів або відсутній доступ
429	Перевищено ліміт частоти запитів
500	Внутрішня помилка сервера

Наступні кроки

Перейдіть до Ace Data Cloud консолі для отримання API Token
Ознайомтеся з документацією API для повного опису параметрів
Перегляньте плани тарифікації для інформації про вартість

Tutorials

​Вступ

​Передумови

​Базове використання

​Обробка відповіді

​Обгортка для Node.js

​Обробка помилок

​Наступні кроки