Hoppa till huvudinnehåll

​
Introduktion

Seedream är en AI-bildtjänst från Ace Data Cloud, baserad på ByteDance Seedream bildgenereringsmodell. Genom Ace Data Clouds enhetliga API kan du snabbt integrera Seedream med Python för att skapa bilder från text, bildredigering, olika upplösningar, vattenmärkeskontroll med mera.

​
Förutsättningar

  • Ett Ace Data Cloud konto och API-token
  • Python 3.7 eller senare
  • Installera requests-biblioteket: pip install requests

​
Grundläggande användning

Huvudendpoint för Seedream API är: 
POST https://api.acedata.cloud/seedream/images
Exemplet använder modellen doubao-seedream-4-0-250828. Tillgängliga modeller inkluderar: doubao-seedream-4-5-251128, doubao-seedream-4-0-250828, doubao-seedream-3-0-t2i-250415, doubao-seededit-3-0-i2i-250628. Fullständigt Python-exempel: 
import requests

url = "https://api.acedata.cloud/seedream/images"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "prompt": "en vit siameskatt som sitter på fönsterbrädan",
    "model": "doubao-seedream-4-0-250828",
    "size": "1K"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Byt ut YOUR_API_TOKEN mot din faktiska token från Ace Data Cloud-plattformen.

​
Hantering av svar

Vid lyckad anrop returnerar API:et data i JSON-format. Kontrollera gärna HTTP-statuskoden: 
if response.status_code == 200:
    result = response.json()
    print("Anrop lyckades:", result)
else:
    print(f"Anrop misslyckades, statuskod: {response.status_code}")
    print(response.text)

​
Avancerad användning

För API:er som stödjer asynkrona uppgifter kan resultat erhållas via callback-URL: 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Resultatet kommer att skickas till din server via callback-URL

​
Felsökning

Vanliga felkoder:
StatuskodBeskrivning
401Autentisering misslyckades, kontrollera API-token
403Otillräcklig balans eller åtkomst nekad
429För många förfrågningar (rate limit)
500Intern serverfel

​
Andra endpoints

Seedream-tjänsten erbjuder även följande endpoint:
  • POST https://api.acedata.cloud/seedream/tasks

​
Nästa steg