Що ви створите
Ви надішлете PNG-завдання1280x768 до FLUX.2 Pro, збережете повернене значення завдання id, виконуватимете опитування за допомогою GET /flux/v1/get_result і завантажите result.sample, коли завдання набуде статусу Ready.
Для синхронного запиту надішліть "async": false і прочитайте result.sample у відповіді на створення. Див. Синхронне генерування для повних прикладів.
Передумови
- Ключ API CometAPI, збережений у
COMETAPI_KEY curlа такожjq, Python 3.10+ ізrequestsабо Node.js 18+- Доступ до
flux-2-proу вашому обліковому записі CometAPI
Кінцеві точки та автентифікація
Надішліть завдання:id верхнього рівня, повернуте у відповіді на створення:
Приклади коду
Синхронне генерування
Щоб отримати готове зображення у відповіді на створення, надішліть булеве значення JSONfalse у async. Успішна відповідь містить status: "Ready" і URL зображення
у result.sample. Використовуйте true або не вказуйте async, щоб використовувати асинхронний робочий процес, описаний
вище. Не надсилайте "false" як рядок і не поєднуйте async: false з
webhook_url або webhook_secret.
Ці приклади очікують до 300 секунд на відповідь на створення, а потім завантажують
зображення. Тайм-аут є налаштуванням клієнта, а не крайнім терміном завершення:
Як працює процес
Заasync: true або без поля async кінцева точка створення повертає завдання верхнього рівня id, поки генерування триває. Опитуйте кінцеву точку результатів CometAPI за допомогою цього id. Ready — успішний кінцевий стан. Вважайте відомі стани помилок і модерації збоями та продовжуйте опитування в інших станах лише до завершення тайм-ауту клієнта.
За async: false успішна відповідь на створення містить status: "Ready" і result.sample. Зчитуйте URL зображення безпосередньо, без опитування.
Використовуйте result.sample лише для завантаження готового зображення. Це тимчасовий URL, який не слід використовувати як постійне сховище застосунку.
Спільні параметри
Усунення несправностей
Завдання залишається в стані обробки
Завдання залишається в стані обробки
Продовжуйте опитування в межах циклу повторних спроб з обмеженням. Якщо досягнуто тайм-ауту клієнта, збережіть ідентифікатор завдання для подальшої перевірки та позначте запит як такий, що завершився за тайм-аутом, а не як успішний.
URL зображення більше не працює
URL зображення більше не працює
Завантажте
result.sample одразу після того, як завдання стане Ready, а потім розмістіть зображення у сховищі, яке контролює ваша програма.Поле запиту не має ефекту
Поле запиту не має ефекту
Скористайтеся Довідка API для генерування зображень FLUX щоб вибрати поля запиту для своєї моделі. Перевірте назви полів і типи JSON за прикладом запиту.
Наступні кроки
- Ознайомтеся з Довідка API для генерування зображень FLUX.
- Опитуйте результати за допомогою Отримання результату зображення FLUX.
- Знайдіть доступні моделі FLUX у Моделі.