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 wywołać Seedream za pomocą cURL, aby tworzyć obrazy na podstawie tekstu, edytować obrazy, korzystać z różnych rozdzielczości oraz kontrolować znaki wodne.

Wymagania wstępne

  • Posiadanie konta w Ace Data Cloud oraz uzyskanie tokenu API
  • Środowisko terminalowe z zainstalowanym cURL

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 polecenia 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"}'
Zamień YOUR_API_TOKEN na rzeczywisty token uzyskany na platformie Ace Data Cloud.

Przykład odpowiedzi

Po pomyślnym wywołaniu zwracane są dane w formacie JSON, na przykład:
{
  "status": "success",
  "data": {
    ...
  }
}

Przetwarzanie odpowiedzi za pomocą jq

Zaleca się użycie narzędzia jq do formatowania wyjścia:
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 .

Obsługa błędów

Typowe kody błędów:
Kod statusuOpis
401Nieautoryzowany, sprawdź token API
403Niewystarczające środki lub brak dostępu
429Przekroczono limit zapytań
500Błąd wewnętrzny serwera

Kolejne kroki