Перейти до основного вмісту

Вступ

Nano Banana — це AI-сервіс зображень від Ace Data Cloud, заснований на сервісі генерації зображень Gemini. За допомогою уніфікованого API Ace Data Cloud ви можете швидко інтегрувати Nano Banana за допомогою JavaScript для створення зображень за текстом, редагування зображень, підтримки різних співвідношень сторін, високої роздільної здатності та інших функцій.

Передумови

  • Наявність облікового запису Ace Data Cloud та отримання API Token
  • Node.js 18+ або сучасне браузерне оточення

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

Головна кінцева точка для виклику Nano Banana API:
POST https://api.acedata.cloud/nano-banana/images
У цьому прикладі використовується модель nano-banana-2. Доступні моделі: nano-banana, nano-banana-2, nano-banana-pro. Повний приклад коду на JavaScript:
const response = await fetch("https://api.acedata.cloud/nano-banana/images", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "action": "generate",
  "prompt": "A white siamese cat",
  "model": "nano-banana-2",
  "aspect_ratio": "1:1"
}),
});

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 callNanoBanana(data) {
  const response = await fetch("https://api.acedata.cloud/nano-banana/images", {
    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Внутрішня помилка сервера

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