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

​
Вступ

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

​
Передумови

  • Наявність облікового запису Ace Data Cloud та отримання API Token
  • Встановлене середовище терміналу з cURL

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

Основна кінцева точка для виклику Nano Banana API: 
POST https://api.acedata.cloud/nano-banana/images
У цьому прикладі використовується модель nano-banana-2. Доступні моделі: nano-banana, nano-banana-2, nano-banana-pro. Повний приклад команди cURL: 
curl -X POST https://api.acedata.cloud/nano-banana/images \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "A white siamese cat", "model": "nano-banana-2", "aspect_ratio": "1:1"}'
Будь ласка, замініть YOUR_API_TOKEN на фактичний токен, отриманий на платформі Ace Data Cloud.

​
Приклад відповіді

Після успішного виклику повертається дані у форматі JSON, наприклад: 
{
  "status": "success",
  "data": {
    ...
  }
}

​
Обробка відповіді за допомогою jq

Рекомендується використовувати інструмент jq для форматування виводу: 
curl -s -X POST https://api.acedata.cloud/nano-banana/images \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "A white siamese cat", "model": "nano-banana-2", "aspect_ratio": "1:1"}' | jq .

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

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

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