Przejdź do głównej treści

​
Wprowadzenie

Flux to usługa AI do generowania obrazów oferowana przez Ace Data Cloud, wykorzystująca model generowania obrazów Black Forest Labs Flux. Za pomocą zunifikowanego API Ace Data Cloud możesz szybko wywołać Flux przy użyciu cURL, realizując funkcje takie jak generowanie obrazów na podstawie tekstu, edycja obrazów, różne modele oraz niestandardowe rozmiary.

​
Wymagania wstępne

  • Konto w Ace Data Cloud oraz uzyskany token API
  • Środowisko terminalowe z zainstalowanym cURL

​
Podstawowe użycie

Główny endpoint API Flux to: 
POST https://api.acedata.cloud/flux/images
W tym przykładzie używamy modelu 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 polecenia 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"}'
Zamień YOUR_API_TOKEN na rzeczywisty token, który uzyskałeś na platformie Ace Data Cloud.

​
Przykład odpowiedzi

Po pomyślnym wywołaniu zwracane są dane w formacie JSON, na przykład: 
{
  "status": "success",
  "data": {
    ...
  }
}

​
Przetwarzanie odpowiedzi za pomocą jq

Zaleca się użycie narzędzia jq do formatowania wyjścia: 
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 .

​
Obsługa błędów

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

​
Kolejne kroki