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

​
Вступ

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

​
Передумови

  • Мати акаунт Ace Data Cloud та отримати API Token
  • Встановлене середовище терміналу з cURL

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

Основна кінцева точка для виклику 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. Повний приклад команди cURL: 
curl -X POST https://api.acedata.cloud/seedream/images \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "一只白色的暹罗猫坐在窗台上", "model": "doubao-seedream-4-0-250828", "size": "1K"}'
Будь ласка, замініть YOUR_API_TOKEN на фактичний токен, отриманий на платформі Ace Data Cloud.

​
Приклад відповіді

Після успішного виклику повертається дані у форматі JSON, наприклад: 
{
  "status": "success",
  "data": {
    ...
  }
}

​
Обробка відповіді за допомогою jq

Рекомендується використовувати інструмент jq для форматованого виводу: 
curl -s -X POST https://api.acedata.cloud/seedream/images \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "一只白色的暹罗猫坐在窗台上", "model": "doubao-seedream-4-0-250828", "size": "1K"}' | jq .

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

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

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