Proces aplikowania
Aby korzystać z API Flux Images Generation, najpierw przejdź do konsoli Ace Data Cloud, aby uzyskać swój API Token i zachować go na później.
Jeśli nie jesteś jeszcze zalogowany lub zarejestrowany, zostaniesz automatycznie przekierowany na stronę logowania z zaproszeniem do rejestracji i zalogowania się, a po zakończeniu automatycznie wrócisz na bieżącą stronę.
Jeden API Token umożliwia wywoływanie wszystkich usług platformy, bez potrzeby osobnego aplikowania dla każdej usługi. Przy pierwszym wniosku otrzymasz darmowy limit, aby móc bezpłatnie wypróbować usługę; gdy limit będzie niewystarczający, możesz doładować saldo ogólne w konsoli.
📘 Pełna dokumentacja: Flux Images Generation API →
Podstawowe użycie
Najpierw zapoznaj się z podstawowym sposobem użycia: wprowadź promptprompt, działanie generowania action oraz rozmiar obrazu size, aby uzyskać przetworzony wynik. Najpierw należy po prostu przekazać pole action o wartości generate, a następnie należy również wprowadzić prompt. Szczegóły są następujące:
accept: format odpowiedzi, który chcesz otrzymać; tutaj należy wpisaćapplication/json, czyli format JSON.authorization: klucz do wywołania API, który po uzyskaniu można bezpośrednio wybrać z listy rozwijanej.
action: działanie dla bieżącego zadania generowania obrazu.size: rozmiar wyniku generowania obrazu. Serieflux-2-flex/flux-2-pro/flux-2-maxmuszą otrzymać proporcje obrazu (np.1:1,16:9), nie akceptują wymiarów w pikselach, takich jak1024x1024; brak wartości zwróci 400.count: liczba generowanych obrazów, wartość domyślna to 1; ten parametr jest skuteczny tylko dla zadań generowania obrazów, a dla zadań edycji jest nieskuteczny.prompt: prompt.model: model generowania, domyślnieflux-dev; najnowsze modele flagowe toflux-2-proiflux-2-max(wyższa jakość obrazu, wymagają proporcji obrazusize).callback_url: URL, na który należy zwrócić wynik poprzez callback.async: opcjonalne; gdy ustawione natrue, interfejs natychmiast zwracatask_id, bez potrzeby podawaniacallback_url, a następnie wynik można uzyskać przez odpytywanie odpowiedniego interfejsu zapytania o zadanie.
size ma pewne szczególne ograniczenia, głównie dzieli się na dwa typy: proporcje szerokości i wysokości width x height oraz proporcje obrazu x:y. Szczegóły są następujące:
Przykładowe proporcje obrazu: “21:9”, “16:9”, “4:3”, “3:2”, “1:1”, “2:3”, “3:4”, “9:16”, “9:21”.
Po wybraniu parametrów odpowiedni kod zostanie automatycznie wygenerowany po prawej stronie. Przed skopiowaniem upewnij się, że nagłówek autoryzacji używa Twojego własnego API Key, a w dokumentacji i zrzutach ekranu nie powinny pojawiać się rzeczywiste dane uwierzytelniające.
Kliknij przycisk „Try”, aby przeprowadzić test. Tutaj otrzymaliśmy następujący wynik:
success, status bieżącego zadania generowania wideo.task_id, ID bieżącego zadania generowania wideo.trace_id, ID śledzenia bieżącego generowania wideo.data, lista wyników bieżącego zadania generowania obrazu.image_url, link do bieżącego zadania generowania obrazu.prompt, prompt.
data wyniku.
Dodatkowo, jeśli chcesz wygenerować odpowiedni kod integracyjny, możesz go bezpośrednio skopiować. Na przykład kod CURL jest następujący:
Zadanie edycji obrazu
Jeśli chcesz edytować określony obraz, najpierw parametrimage_url musi zawierać link do obrazu, który należy edytować. W tym przypadku action obsługuje wyłącznie edit, dzięki czemu można określić następujące treści:
- model: model używany przez bieżące zadanie edycji obrazu, obsługuje
flux-dev,flux-pro,flux-kontext-pro,flux-kontext-max,flux-2-flex,flux-2-pro,flux-2-max. - image_url: prześlij obraz, który należy edytować.
Asynchroniczne wywołanie zwrotne
Ponieważ czas generowania przez Flux Images Generation API jest stosunkowo długi i wynosi około 1–2 minut, jeśli API przez długi czas nie odpowiada, żądanie HTTP będzie stale utrzymywać połączenie, co prowadzi do dodatkowego zużycia zasobów systemowych, dlatego to API również zapewnia obsługę asynchronicznych wywołań zwrotnych. Ogólny proces wygląda następująco: gdy klient inicjuje żądanie, dodatkowo określa polecallback_url, po wysłaniu przez klienta żądania API, API natychmiast zwróci wynik zawierający informacje o polu task_id, które reprezentuje ID bieżącego zadania. Po ukończeniu zadania wynik wygenerowanego obrazu zostanie wysłany w formie POST JSON na callback_url określony przez klienta, gdzie również zawarte będzie pole task_id, dzięki czemu wyniki zadania mogą zostać powiązane za pomocą ID.
Poniżej na przykładzie zobaczymy, jak konkretnie należy to zrobić.
Po pierwsze, wywołanie zwrotne Webhook to usługa, która może odbierać żądania HTTP, a programista powinien zastąpić je adresem URL własnego serwera HTTP. Dla wygody demonstracji użyto tutaj publicznej przykładowej strony Webhook https://webhook.site/; po otwarciu tej strony można uzyskać URL Webhook, jak pokazano na ilustracji:
Skopiowanie tego URL umożliwia użycie go jako Webhooka, a przykładem w tym miejscu jest https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab.
Następnie możemy ustawić pole callback_url na powyższy URL Webhook, jednocześnie wypełniając odpowiednie parametry, a konkretna zawartość jest pokazana na ilustracji:
https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab, jak pokazano na ilustracji:
Treść jest następująca:
task_id, a pozostałe pola są podobne do opisanych powyżej; za pomocą tego pola można zrealizować powiązanie zadań.
Obsługa błędów
Podczas wywoływania API, jeśli wystąpi błąd, API zwróci odpowiedni kod błędu i informację. Na przykład:400 token_mismatched: Nieprawidłowe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.400 api_not_implemented: Nieprawidłowe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.401 invalid_token: Brak autoryzacji, nieprawidłowy lub brakujący token autoryzacyjny.429 too_many_requests: Zbyt wiele żądań, przekroczono limit częstotliwości.500 api_error: Wewnętrzny błąd serwera, coś poszło nie tak na serwerze.