Przejdź do głównej treści

​
Wprowadzenie

Flux to usługa AI do generowania obrazów oferowana przez Ace Data Cloud, oparta na modelu generowania obrazów Black Forest Labs Flux. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko zintegrować Flux w Pythonie, realizując funkcje takie jak generowanie obrazów z tekstu, edycja zdjęć, różne modele oraz niestandardowe rozmiary.

​
Wymagania wstępne

  • Konto w Ace Data Cloud oraz uzyskany token API
  • Środowisko Python w wersji 3.7 lub wyższej
  • Zainstalowana biblioteka requests: pip install requests

​
Podstawowe użycie

Główny endpoint API Flux to: 
POST https://api.acedata.cloud/flux/images
W tym przykładzie używany jest model flux-pro-1.1. Dostępne modele to: flux-dev, flux-pro, flux-pro-1.1, flux-pro-1.1-ultra, flux-kontext-pro, flux-kontext-max. Pełny przykład kodu w Python: 
import requests

url = "https://api.acedata.cloud/flux/images"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "action": "generate",
    "prompt": "A white siamese cat sitting on a windowsill",
    "model": "flux-pro-1.1",
    "size": "1024x1024"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Zamień YOUR_API_TOKEN na rzeczywisty token uzyskany na platformie Ace Data Cloud.

​
Obsługa odpowiedzi

Po pomyślnym wywołaniu API zwraca dane w formacie JSON. Zaleca się sprawdzenie kodu statusu HTTP: 
if response.status_code == 200:
    result = response.json()
    print("Wywołanie zakończone sukcesem:", result)
else:
    print(f"Wywołanie nie powiodło się, kod statusu: {response.status_code}")
    print(response.text)

​
Zaawansowane użycie

Dla API obsługującego zadania asynchroniczne można uzyskać wynik poprzez URL zwrotny (callback): 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Wynik zostanie przesłany na Twój serwer przez callback URL

​
Obsługa błędów

Typowe kody błędów:
Kod statusuOpis
401Błąd uwierzytelniania, sprawdź token API
403Niewystarczające środki lub brak uprawnień
429Przekroczono limit żądań
500Błąd wewnętrzny serwera

​
Inne endpointy

Usługa Flux udostępnia również następujące endpointy:
  • POST https://api.acedata.cloud/flux/tasks

​
Kolejne kroki