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. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko zintegrować Flux w JavaScript, 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
  • Node.js 18+ lub nowoczesne środowisko przeglądarki

​
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 JavaScript: 
const response = await fetch("https://api.acedata.cloud/flux/images", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "action": "generate",
  "prompt": "A white siamese cat sitting on a windowsill",
  "model": "flux-pro-1.1",
  "size": "1024x1024"
}),
});

const result = await response.json();
console.log(result);
Proszę zastąpić YOUR_API_TOKEN rzeczywistym tokenem uzyskanym na platformie Ace Data Cloud.

​
Obsługa odpowiedzi

Zaleca się sprawdzenie statusu odpowiedzi i obsługę błędów: 
if (response.ok) {
  const result = await response.json();
  console.log("Wywołanie zakończone sukcesem:", result);
} else {
  console.error(`Wywołanie nie powiodło się, kod statusu: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

​
Opakowanie dla Node.js

Zaleca się opakowanie w funkcję wielokrotnego użytku: 
async function callFlux(data) {
  const response = await fetch("https://api.acedata.cloud/flux/images", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`Błąd API: ${response.status}`);
  return response.json();
}

​
Obsługa błędów

Typowe kody błędów:
Kod statusuOpis
401Nieautoryzowany, sprawdź token API
403Niewystarczające środki lub brak dostępu
429Przekroczona częstotliwość żądań
500Wewnętrzny błąd serwera

​
Kolejne kroki