SeeDream Bilder Generering API Integrationsbeskrivning

Denna artikel kommer att introducera en SeeDream Bilder Generering API integrationsbeskrivning, som kan generera SeeDreams officiella bilder genom att ange anpassade parametrar.

Ansökningsprocess

För att använda SeeDream Bilder Generering API, börja med att gå till Ace Data Cloud-konsolen för att få din API-token, som du ska spara.

Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till inloggningssidan för att registrera dig och logga in, och efter att ha slutfört detta kommer du automatiskt att återvända till den aktuella sidan. En API-token kan användas för att anropa alla tjänster på plattformen, utan att behöva ansöka separat för varje tjänst. Första ansökan ger en gratis kvot, så att du kan prova gratis; när kvoten är slut kan du ladda på allmän balans i konsolen.

📘 Fullständig dokumentation: SeeDream Bilder Generering API →

Grundläggande användning

Först bör du förstå den grundläggande användningen, vilket innebär att du anger en prompt prompt, en genereringsåtgärd action, och bildstorlek size, för att få det bearbetade resultatet. Först behöver vi enkelt skicka ett action-fält, vars värde är generate, och sedan behöver vi också ange en prompt, den specifika informationen är som följer:

Här kan vi se att vi har ställt in Request Headers, inklusive:

accept: vilken format av svar du vill ta emot, här anges som application/json, det vill säga JSON-format.
authorization: nyckeln för att anropa API:et, som kan väljas direkt efter ansökan.

Dessutom har vi ställt in Request Body, inklusive:

prompt: prompt.
model: genereringsmodell, standard doubao-seedream-5-0-260128 (SeeDream 5.0 Lite, den senaste). Stöder doubao-seedream-5-0-pro-260628, doubao-seedream-5-0-260128, doubao-seedream-4-5-251128, doubao-seedream-4-0-250828, doubao-seedream-3-0-t2i-250415, doubao-seededit-3-0-i2i-250628. Bland dessa är doubao-seedream-5-0-pro-260628 (SeeDream 5.0 Pro) en flaggskeppsmodell för enskilda bilder, som endast genererar en bild, stödjer inte bildserier (sequential_image_generation), strömmande (stream) eller nätverksökning (tools). model måste anges med hela modellsträngen (som doubao-seedream-5-0-260128), att ange doubao-seedream-5.0-lite som en förkortning kommer att returnera 400.
image: information om den inmatade bilden, stöder URL eller Base64-kodning. Bland dessa stöder doubao-seedream-5-0-pro-260628 enskild eller flera bilder (flera bilder 2-10 stycken, från och med den andra bilden debiteras per bild), doubao-seedream-5-0-260128, doubao-seedream-4-5-251128, doubao-seedream-4-0-250828 stöder enskild eller flera bilder, doubao-seededit-3-0-i2i-250628 stöder endast enskild bild, doubao-seedream-3-0-t2i-250415 stöder inte denna parameter.
size: specificera storleksinformationen för den genererade bilden, stöder följande två metoder, som inte kan blandas. Metod 1 | Specificera upplösningen för den genererade bilden och beskriv bildens bredd-höjd-förhållande med naturligt språk i prompten. De förinställningar som stöds varierar mellan modeller: doubao-seedream-5-0-pro-260628 stöder 1K/2K; doubao-seedream-5-0-260128 stöder 2K/3K/4K; doubao-seedream-4-5-251128 stöder endast 2K/4K; doubao-seedream-4-0-250828 stöder 1K/2K/4K; doubao-seedream-3-0-t2i-250415 och doubao-seededit-3-0-i2i-250628 stöder inte förinställningar, accepterar endast metod 2. Metod 2 | Specificera pixelvärdena för bredd och höjd för den genererade bilden: standard 2048x2048, det totala pixelantalet och bredd-höjd-förhållandet varierar beroende på modellen (till exempel 5.0 Pro har ett totalt pixelområde [921600, 4194304], 5.0 Lite / 4.5 har ett lägsta pixelantal på 3,686,400, 4.0 har ett lägsta antal på 921,600, 3.0-t2i / seededit-3.0-i2i har ett område [512x512, 2048x2048]).
seed: slumpmässig frö, används för att kontrollera modellens innehållsgenereringens slumpmässighet. Värdeintervallet är [-1, 2147483647]. Endast doubao-seedream-3-0-t2i-250415 stöder denna parameter.
sequential_image_generation: bildserie: en uppsättning bilder som genereras baserat på det innehåll du anger. doubao-seedream-5-0-260128, doubao-seedream-4-5-251128, doubao-seedream-4-0-250828 stöder denna parameter, standard disabled.
stream: kontrollerar om strömmande utdata-läge ska aktiveras. doubao-seedream-5-0-260128, doubao-seedream-4-5-251128, doubao-seedream-4-0-250828 stöder denna parameter, standard är false.
guidance_scale: graden av överensstämmelse mellan modellens utdata och prompten, ju högre värde desto starkare korrelation. Värdeintervallet är [1, 10]. doubao-seedream-3-0-t2i-250415 har standardvärde 2.5, doubao-seededit-3-0-i2i-250628 har standardvärde 5.5, andra modeller stöder inte.
response_format: specificera returformatet för den genererade bilden. Standard är url, stöder även b64_json.
watermark: om en vattenstämpel ska läggas till i den genererade bilden. Standard är true.
output_format: specificera filformatet för den genererade bilden, stöder jpeg (standard) och png. Endast doubao-seedream-5-0-pro-260628 och doubao-seedream-5-0-260128 stöder.
tools: konfigurera verktygen som modellen ska anropa, för närvarande stöder web_search (nätverksökning). Endast doubao-seedream-5-0-260128 stöder.
callback_url: URL för att få tillbaka resultatet.
async: om det ska behandlas i asynkront läge. Sätt till true så returnerar gränssnittet omedelbart task_id, utan att behöva ange callback_url, och sedan kan resultatet hämtas genom att pollera /seedream/tasks.

När du har valt kan du se att motsvarande kod också har genererats till höger, som visas i bilden:

Klicka på “Try” knappen för att testa, som visas i bilden ovan, här har vi fått följande resultat:

{
  "success": true,
  "task_id": "81246f86-05ff-4d7d-9553-1013e0c1cd32",
  "trace_id": "ab50a78d-ab1f-457f-a46b-c2259cd5d35b",
  "data": [
    {
      "prompt": "En fotorealistisk studio produktbild av en frostat glasparfymflaska på blöt svart skiffer, en enda softbox nyckellampa, vattendroppar, mörk stämningsfull bakgrund, 85mm makro.",
      "size": "2048x2048",
      "image_url": "https://platform2.cdn.acedata.cloud/seedream/901c6af6-e83a-4849-b233-295f6c20bacb.jpg"
    }
  ]
}

Resultatet innehåller flera fält, som beskrivs nedan:

success, status för videoproduktionsuppgiften vid detta tillfälle.
task_id, ID för videoproduktionsuppgiften vid detta tillfälle.
trace_id, spårnings-ID för videoproduktionsuppgiften vid detta tillfälle.
data, resultatlistan för bildproduktionsuppgiften vid detta tillfälle.
- image_url, länken till bildproduktionsuppgiften vid detta tillfälle.
- prompt, uppmaning.
- size: pixelstorleken för den genererade bilden.

Vi kan se att vi har fått tillfredsställande bildinformation, vi behöver bara hämta den genererade SeeDream-bilden baserat på bildlänken i data. Om du vill generera motsvarande kod kan du direkt kopiera den, till exempel CURL-koden nedan:

curl -X POST 'https://api.acedata.cloud/seedream/images' \
-H 'accept: application/json' \
-H 'authorization: Bearer ${token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "doubao-seedream-5-0-260128",
  "prompt": "En fotorealistisk studio produktbild av en frostat glasparfymflaska på blöt svart skiffer, en enda softbox nyckellampa, vattendroppar, mörk stämningsfull bakgrund, 85mm makro."
}'

Redigera bilduppgift

Om du vill redigera en viss bild måste du först ange parametern image med länken till den bild som ska redigeras.

model: modellen som används för denna redigeringsuppgift, doubao-seedream-5-0-260128, doubao-seedream-4-5-251128, doubao-seedream-4-0-250828 stödjer enstaka eller flera bilder, doubao-seededit-3-0-i2i-250628 stödjer endast enstaka bildinmatning.
image: ladda upp den bild som ska redigeras, en eller flera.

Exempel på ifyllning:

Motsvarande kod:

import requests

url = "https://api.acedata.cloud/flux/images"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "model": "doubao-seedream-4-0-250828",
  "prompt": "Behåll modellens pose och den flytande klädesplaggens form oförändrad. Ändra klädmaterialet från silvermetall till helt transparent vatten (eller glas). Genom vätskan är detaljerna av modellens hud synliga. Ljus- och skuggeffekten skiftar från reflektion till refraktion.",
  "image": ["https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imageToimage.png"],
  "size": "2K",
  "watermark": False
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Klicka på kör, och du kan se att du omedelbart får ett resultat, som nedan:

{
    "success": true,
    "task_id": "c9aaffa2-b8ac-40ff-8468-43e77cb9ddde",
    "trace_id": "131a40c3-2eaf-44c9-af28-c9b408577286",
    "data": [
        {
            "prompt": "Behåll modellens pose och den flytande klädesplaggens form oförändrad. Ändra klädmaterialet från silvermetall till helt transparent vatten (eller glas). Genom vätskan är detaljerna av modellens hud synliga. Ljus- och skuggeffekten skiftar från reflektion till refraktion.",
            "size": "2048x2048",
            "image_url": "https://platform.cdn.acedata.cloud/seedream/3e88db7e-4771-4f6a-adbd-5ae4590c5d59.jpg"
        }
    ]
}

Vi kan se att den genererade effekten är en redigering av den ursprungliga bilden, resultatet liknar det ovan.

Asynkron återkoppling

Eftersom SeeDream Images Generation API tar relativt lång tid att generera, cirka 1-2 minuter, om API:n inte svarar under en längre tid, kommer HTTP-förfrågan att hålla anslutningen öppen, vilket leder till extra systemresursförbrukning, så detta API erbjuder också stöd för asynkron återkoppling. Den övergripande processen är: när klienten initierar en begäran, specificera ett extra callback_url-fält, efter att klienten har initierat API-begäran kommer API:n omedelbart att returnera ett resultat som innehåller ett task_id-fält, vilket representerar det aktuella uppgifts-ID:t. När uppgiften är klar kommer resultatet av den genererade bilden att skickas till klientens angivna callback_url i POST JSON-format, vilket också inkluderar task_id-fältet, så att uppgiftsresultatet kan kopplas ihop med ID:t. Om du inte har en offentlig adress för återkoppling kan du också välja att inte specificera callback_url, utan istället ställa in async-fältet till true i begäran. I detta fall kommer gränssnittet också omedelbart att returnera task_id, men resultatet kommer inte att skickas, du måste använda det task_id för att anropa /seedream/tasks-gränssnittet för att pollera uppgiftsstatus för att få det slutliga resultatet. Låt oss förstå hur man gör detta genom ett exempel. Klicka på kör, och du kan se att du omedelbart får ett resultat, som nedan:

{
  "task_id": "c9aaffa2-b8ac-40ff-8468-43e77cb9ddde"
}

Innehållet är som följer:

{
    "success": true,
    "task_id": "c9aaffa2-b8ac-40ff-8468-43e77cb9ddde",
    "trace_id": "131a40c3-2eaf-44c9-af28-c9b408577286",
    "data": [
        {
            "prompt": "Behåll modellens pose och den flytande klädesplaggens form oförändrad. Ändra klädmaterialet från silvermetall till helt transparent vatten (eller glas). Genom vätskan är detaljerna av modellens hud synliga. Ljus- och skuggeffekten skiftar från reflektion till refraktion.",
            "size": "2048x2048",
            "image_url": "https://platform.cdn.acedata.cloud/seedream/3e88db7e-4771-4f6a-adbd-5ae4590c5d59.jpg"
        }
    ]
}

Vi kan se att resultatet innehåller ett task_id-fält, och de andra fälten liknar de ovan, genom detta fält kan uppgiften kopplas samman.

Felhantering

När du anropar API:n, om du stöter på fel, kommer API:n att returnera motsvarande felkod och information. Till exempel:

400 token_mismatched: Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.
400 api_not_implemented: Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.
401 invalid_token: Obefogad, ogiltig eller saknad auktoriseringstoken.
429 too_many_requests: För många förfrågningar, du har överskridit hastighetsgränsen.
500 api_error: Intern serverfel, något gick fel på servern.

Exempel på felrespons

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "hämtning misslyckades"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Slutsats

Genom detta dokument har du fått en förståelse för hur du använder SeeDream Images Generation API för att generera bilder genom att ange ledord. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda API:et. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.

Getting Started

AI Samtal

AI Bild

AI Video

AI Ljud

Web & Data

CAPTCHA

Identitet

Proxy

Advanced

SeeDream Bilder Generering API Integrationsbeskrivning

Ansökningsprocess

Grundläggande användning

Redigera bilduppgift

Asynkron återkoppling

Felhantering

Exempel på felrespons

Slutsats

​Ansökningsprocess

​Grundläggande användning

​Redigera bilduppgift

​Asynkron återkoppling

​Felhantering

​Exempel på felrespons

​Slutsats

Ansökningsprocess

Grundläggande användning

Redigera bilduppgift

Asynkron återkoppling

Felhantering

Exempel på felrespons

Slutsats