Flux Images Generation API Integracja

W tym artykule przedstawimy sposób integracji z API Flux Images Generation, które pozwala na generowanie oficjalnych obrazów Flux poprzez wprowadzenie niestandardowych parametrów.

Proces aplikacji

Aby skorzystać z API Flux Images Generation, najpierw przejdź do konsoli Ace Data Cloud, aby uzyskać swój token API, który należy zachować na przyszłość.

Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować, a po zakończeniu zostaniesz automatycznie przekierowany z powrotem na bieżącą stronę. Jeden token API wystarczy do wywołania wszystkich usług platformy, nie ma potrzeby składania osobnych wniosków dla każdej usługi. Przy pierwszym wniosku otrzymasz darmowy limit, aby móc go przetestować; gdy limit się wyczerpie, 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, polegającym na wprowadzeniu słowa kluczowego prompt, działania action, rozmiaru obrazu size, aby uzyskać przetworzony wynik. Najpierw musisz przekazać pole action, którego wartość to generate, a następnie musimy wprowadzić słowo kluczowe, szczegóły są następujące:

Możemy zobaczyć, że ustawiliśmy nagłówki żądania, w tym:

accept: jakiego formatu odpowiedzi oczekujesz, tutaj wpisujemy application/json, czyli format JSON.
authorization: klucz do wywołania API, po złożeniu wniosku można go bezpośrednio wybrać z rozwijanej listy.

Dodatkowo ustawiono ciało żądania, w tym:

action: działanie związane z zadaniem generowania obrazu.
size: rozmiar generowanego obrazu. Seria flux-2-flex / flux-2-pro / flux-2-max musi przekazać proporcje obrazu (np. 1:1, 16:9), nie akceptuje rozmiarów pikselowych takich jak 1024x1024, domyślnie zwróci 400.
count: liczba generowanych obrazów, domyślna wartość to 1, ten parametr jest ważny tylko w przypadku zadania generowania obrazów, w przypadku edytowania jest nieważny.
prompt: słowo kluczowe.
model: model generowania, domyślnie flux-dev; najnowsze flagowe to flux-2-pro, flux-2-max (wyższa jakość obrazu, wymaga współpracy z proporcją obrazu size).
callback_url: URL, na który mają być zwracane wyniki.
async: opcjonalne, ustawione na true, interfejs natychmiast zwraca task_id, nie ma potrzeby podawania callback_url, a następnie można uzyskać wyniki poprzez odpowiedni interfejs zapytań o zadania.

Parametr size ma pewne szczególne ograniczenia, głównie dzieli się na proporcje width x height oraz proporcje obrazu x:y, szczegóły są następujące:

Model	Zakres
flux-dev	Obsługuje proporcje 1024x1024, 1024x1792, 1792x1024, lub proporcje obrazu
flux-pro	Obsługuje proporcje 1024x1024, 1024x1792, 1792x1024, lub proporcje obrazu
flux-2-flex	Obsługuje tylko proporcje obrazu
flux-2-pro	Obsługuje tylko proporcje obrazu
flux-2-max	Obsługuje tylko proporcje obrazu
flux-kontext-pro	Obsługuje tylko proporcje obrazu
flux-kontext-max	Obsługuje tylko proporcje obrazu

Proporcje obrazu do wyboru: “21:9”, “16:9”, “4:3”, “3:2”, “1:1”, “2:3”, “3:4”, “9:16”, “9:21”. Po wybraniu parametrów, po prawej stronie automatycznie generowany jest odpowiedni kod. Przed skopiowaniem upewnij się, że nagłówek autoryzacji używa twojego własnego klucza API, dokumentacja i zrzuty ekranu nie powinny zawierać prawdziwych danych uwierzytelniających. Kliknij przycisk „Try”, aby przeprowadzić test, a otrzymamy następujący wynik:

{
  "success": true,
  "task_id": "5456c749-3bbb-4f10-9eb8-cfbcac297500",
  "trace_id": "ae4eecb8-1dd6-45b4-bfb3-a1c48872536e",
  "data": [
    {
      "image_url": "https://platform2.cdn.acedata.cloud/flux/5456c749-3bbb-4f10-9eb8-cfbcac297500.jpg"
    }
  ]
}

Zwrócony wynik zawiera wiele pól, które są opisane poniżej:

success, status zadania generowania obrazu.
task_id, ID zadania generowania obrazu.
trace_id, ID śledzenia zadania generowania obrazu.
data, lista wyników zadania generowania obrazu.
- image_url, link do zadania generowania obrazu.
- prompt, słowo kluczowe.

Możemy zobaczyć, że otrzymaliśmy satysfakcjonujące informacje o obrazie, wystarczy, że na podstawie adresu URL obrazu w data uzyskamy wygenerowany obraz Flux. Jeśli chcesz wygenerować odpowiedni kod do integracji, możesz go bezpośrednio skopiować, na przykład kod CURL wygląda następująco:

curl -X POST 'https://api.acedata.cloud/flux/images' \
-H 'authorization: Bearer {token}' \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "prompt": "A photorealistic studio product shot of a frosted-glass perfume bottle on wet black slate, single softbox key light, water droplets, dark moody background, 85mm macro.",
  "model": "flux-2-pro",
  "size": "1:1"
}'

Edytowanie zadań obrazów

Jeśli chcesz edytować dany obraz, najpierw parametr image_url musi zawierać link do obrazu, który ma być edytowany, w tym przypadku action obsługuje tylko edit, co pozwala na określenie następujących treści:

model: model używany w zadaniu edytowania obrazu, obsługuje flux-dev, flux-pro, flux-kontext-pro, flux-kontext-max, flux-2-flex, flux-2-pro, flux-2-max.
image_url: link do przesyłanego obrazu do edycji.

Przykład wypełnienia jest następujący:

Po wypełnieniu automatycznie wygenerowano kod, jak poniżej:

Odpowiedni kod:

import requests

url = "https://api.acedata.cloud/flux/images"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "action": "edit",
    "prompt": "a white siamese cat",
    "model": "flux-kontext-pro",
    "image_url": "https://cdn.acedata.cloud/ytj2qy.png"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Po kliknięciu „Uruchom” można zauważyć, że natychmiast otrzymujemy wynik, jak poniżej:

{
  "success": true,
  "task_id": "2a7979ff-1f77-4380-92c6-a2dc37c3b4c8",
  "trace_id": "732b65c0-48d9-49f7-b568-64e5acffe4c0",
  "data": [
    {
      "prompt": "a white siamese cat",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "timings": 1752744073
    }
  ]
}

Można zobaczyć, że wygenerowany efekt to efekt edycji oryginalnego obrazu, a wynik jest podobny do powyższego.

Asynchroniczne wywołanie zwrotne

Ponieważ czas generacji API Flux Images Generation jest stosunkowo długi, wynosi około 1-2 minut, jeśli API nie odpowiada przez dłuższy czas, żądanie HTTP będzie utrzymywać połączenie, co prowadzi do dodatkowego zużycia zasobów systemowych, dlatego to API oferuje również wsparcie dla asynchronicznych wywołań zwrotnych. Cały proces wygląda następująco: gdy klient wysyła żądanie, dodatkowo określa pole callback_url, po wysłaniu żądania API natychmiast zwraca wynik, zawierający informacje o polu task_id, które reprezentuje bieżące ID zadania. Po zakończeniu zadania wynik wygenerowanego obrazu zostanie wysłany do określonego przez klienta callback_url w formie POST JSON, w tym również zawierając pole task_id, dzięki czemu wyniki zadania można powiązać za pomocą ID. Poniżej przyjrzymy się, jak to dokładnie działa na przykładzie. Po pierwsze, wywołanie zwrotne Webhook to usługa, która może odbierać żądania HTTP, deweloperzy powinni zastąpić to URL swojego własnego serwera HTTP. W tym celu, dla wygody demonstracji, użyjemy publicznej strony przykładowej Webhook https://webhook.site/, otwierając tę stronę, można uzyskać URL Webhook, jak pokazano na obrazku:

Skopiuj ten URL, aby móc go używać jako Webhook, przykładowy URL to https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab. Następnie możemy ustawić pole callback_url na powyższy URL Webhook, a także wypełnić odpowiednie parametry, szczegóły jak na obrazku:

Klikając uruchom, można zauważyć, że natychmiast otrzymujemy wynik, jak poniżej:

{
  "task_id": "6a97bf49-df50-4129-9e46-119aa9fca73c"
}

Po chwili możemy na https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab zaobserwować wynik wygenerowanego obrazu, jak pokazano na obrazku:

Treść jest następująca:

{
  "success": true,
  "task_id": "6a97bf49-df50-4129-9e46-119aa9fca73c",
  "trace_id": "9b4b1ff3-90f2-470f-b082-1061ec2948cc",
  "data": [
    {
      "prompt": "a white siamese cat",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "seed": 1698551532,
      "timings": {
        "inference": 3.328
      }
    }
  ]
}

Można zauważyć, że w wyniku znajduje się pole task_id, a inne pola są podobne do powyższych, dzięki czemu można powiązać wyniki zadania za pomocą tego pola.

Obsługa błędów

Podczas wywoływania API, jeśli wystąpi błąd, API zwróci odpowiedni kod błędu i informacje. Na przykład:

400 token_mismatched: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
400 api_not_implemented: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
401 invalid_token: Nieautoryzowany, nieprawidłowy lub brakujący token autoryzacyjny.
429 too_many_requests: Zbyt wiele żądań, przekroczono limit szybkości.
500 api_error: Błąd wewnętrzny serwera, coś poszło nie tak na serwerze.

Przykład odpowiedzi błędu

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Wnioski

Dzięki temu dokumentowi zrozumieliście, jak korzystać z API Flux Images Generation, aby generować obrazy na podstawie wprowadzonych podpowiedzi. Mamy nadzieję, że ten dokument pomoże Wam lepiej zintegrować i korzystać z tego API. W razie jakichkolwiek pytań, prosimy o kontakt z naszym zespołem wsparcia technicznego.

Getting Started

Czat AI

Obraz AI

Wideo AI

Audio AI

Sieć i dane

CAPTCHA

Tożsamość

Proxy

Advanced

Coding

Flux Images Generation API Integracja

Proces aplikacji

Podstawowe użycie

Edytowanie zadań obrazów

Asynchroniczne wywołanie zwrotne

Obsługa błędów

Przykład odpowiedzi błędu

Wnioski

​Proces aplikacji

​Podstawowe użycie

​Edytowanie zadań obrazów

​Asynchroniczne wywołanie zwrotne

​Obsługa błędów

​Przykład odpowiedzi błędu

​Wnioski

Proces aplikacji

Podstawowe użycie

Edytowanie zadań obrazów

Asynchroniczne wywołanie zwrotne

Obsługa błędów

Przykład odpowiedzi błędu

Wnioski