Przejdź do głównej treści

Wprowadzenie

Seedream to usługa AI do generowania obrazów oferowana przez Ace Data Cloud, wykorzystująca model generowania obrazów Seedream firmy ByteDance. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko zintegrować Seedream za pomocą JavaScript, realizując funkcje takie jak generowanie obrazów na podstawie tekstu, edycja zdjęć, obsługa różnych rozdzielczości oraz kontrola znaków wodnych.

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 Seedream to:
POST https://api.acedata.cloud/seedream/images
W tym przykładzie używany jest model doubao-seedream-4-0-250828. Dostępne modele to: doubao-seedream-4-5-251128, doubao-seedream-4-0-250828, doubao-seedream-3-0-t2i-250415, doubao-seededit-3-0-i2i-250628. Pełny przykład kodu JavaScript:
const response = await fetch("https://api.acedata.cloud/seedream/images", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "prompt": "biały kot syjamski siedzący na parapecie",
  "model": "doubao-seedream-4-0-250828",
  "size": "1K"
}),
});

const result = await response.json();
console.log(result);
Proszę zamienić YOUR_API_TOKEN na rzeczywisty token uzyskany na platformie Ace Data Cloud.

Obsługa odpowiedzi

Zaleca się sprawdzanie 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 wywołania w funkcję wielokrotnego użytku:
async function callSeedream(data) {
  const response = await fetch("https://api.acedata.cloud/seedream/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ść zapytań
500Błąd wewnętrzny serwera

Kolejne kroki