Перейти до основного вмісту

​
Вступ

Seedream — це AI-сервіс зображень від Ace Data Cloud, модель генерації зображень Seedream від ByteDance. За допомогою уніфікованого API Ace Data Cloud ви можете швидко інтегрувати Seedream за допомогою JavaScript, реалізуючи функції генерації зображень за текстом, редагування зображень, підтримку різних роздільних здатностей, керування водяними знаками тощо.

​
Передумови

  • Наявність облікового запису Ace Data Cloud та отримання API Token
  • Node.js 18+ або сучасне браузерне середовище

​
Базове використання

Головна кінцева точка для виклику Seedream API: 
POST https://api.acedata.cloud/seedream/images
У цьому прикладі використовується модель doubao-seedream-4-0-250828.
Доступні моделі: doubao-seedream-4-5-251128, doubao-seedream-4-0-250828, doubao-seedream-3-0-t2i-250415, doubao-seededit-3-0-i2i-250628. Повний приклад коду на 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": "一只白色的暹罗猫坐在窗台上",
  "model": "doubao-seedream-4-0-250828",
  "size": "1K"
}),
});

const result = await response.json();
console.log(result);
Будь ласка, замініть YOUR_API_TOKEN на фактичний токен, отриманий на платформі Ace Data Cloud.

​
Обробка відповіді

Рекомендується перевіряти код статусу відповіді та обробляти помилки: 
if (response.ok) {
  const result = await response.json();
  console.log("Виклик успішний:", result);
} else {
  console.error(`Виклик не вдався, код статусу: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

​
Обгортка для Node.js

Рекомендується оформити у вигляді багаторазової функції: 
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(`API error: ${response.status}`);
  return response.json();
}

​
Обробка помилок

Поширені коди помилок:
Код статусуОпис
401Помилка автентифікації, перевірте API Token
403Недостатньо коштів або відсутній доступ
429Перевищено ліміт частоти запитів
500Внутрішня помилка сервера

​
Наступні кроки