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

​
Вступ

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

​
Передумови

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

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

Основна кінцева точка для виклику Flux API: 
POST https://api.acedata.cloud/flux/images
У цьому прикладі використовується модель flux-pro-1.1. Доступні моделі: flux-dev, flux-pro, flux-pro-1.1, flux-pro-1.1-ultra, flux-kontext-pro, flux-kontext-max. Повний приклад команди cURL: 
curl -X POST https://api.acedata.cloud/flux/images \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "A white siamese cat sitting on a windowsill", "model": "flux-pro-1.1", "size": "1024x1024"}'
Замість YOUR_API_TOKEN вставте фактичний токен, отриманий на платформі Ace Data Cloud.

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

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

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

Рекомендується використовувати інструмент jq для форматування виводу: 
curl -s -X POST https://api.acedata.cloud/flux/images \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "A white siamese cat sitting on a windowsill", "model": "flux-pro-1.1", "size": "1024x1024"}' | jq .

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

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

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