Przejdź do głównej treści

Wprowadzenie

Face Change to usługa AI do przetwarzania obrazów i twarzy oferowana przez Ace Data Cloud. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko zintegrować Face Change za pomocą JavaScript, realizując funkcje takie jak zamiana twarzy, upiększanie twarzy, zmiana wieku, zmiana płci, animizacja oraz analiza twarzy.

Wymagania wstępne

  • Posiadanie konta w Ace Data Cloud oraz uzyskanie API Token
  • Node.js 18+ lub nowoczesne środowisko przeglądarki

Podstawowe użycie

Główny endpoint API Face Change to:
POST https://api.acedata.cloud/face/swap
Pełny przykład kodu JavaScript:
const response = await fetch("https://api.acedata.cloud/face/swap", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "source_image_url": "https://example.com/source-face.jpg",
  "target_image_url": "https://example.com/target-face.jpg"
}),
});

const result = await response.json();
console.log(result);
Zamień YOUR_API_TOKEN na rzeczywisty token uzyskany na platformie Ace Data Cloud.

Obsługa odpowiedzi

Zaleca się sprawdzenie kodu 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 w Node.js

Zaleca się opakowanie w funkcję wielokrotnego użytku:
async function callFaceChange(data) {
  const response = await fetch("https://api.acedata.cloud/face/swap", {
    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ź API Token
403Niewystarczające środki lub brak dostępu
429Przekroczona częstotliwość żądań
500Błąd wewnętrzny serwera

Kolejne kroki