Seedream 5.5 API: obrazy NSFW 4k, edycja, warstwy

bytedance/seedream-5.5/edit

ByteDance opracowało Seedream 5.5, aby kolejne edycje nie powodowały niezamierzonych zmian w obrazie. Według ByteDance obszary niepoddawane edycji pozostają stabilne przez ponad 100 rund zmian. W porównaniu z Seedream 5.0 Pro dostępny jest także eksport do 4k oraz niższa cena dla każdego wspólnego rozmiaru. W jednym żądaniu możesz użyć do dziesięciu referencji.

Od $0.019/obraz

Uruchom model Zobacz API

Wyślij żądanie

Przykłady korzystają z publicznych definicji parametrów wybranego endpointu. Podmień klucz API i przykładowe media, a potem wyślij żądanie ze swojego serwera.

SDK i integracje

POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

Uwierzytelnianie API

Klucz API trzymaj w zmiennej środowiskowej serwera SPICY_API_KEY. Dla żądań JSON używaj uwierzytelniania Bearer i Content-Type: application/json.

Authorization: Bearer $SPICY_API_KEY

Seedream 5.5 · Image Editing · Przykładowy wynik — Przykładowy wynikUżyj tego przykładu

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seedream-5.5/edit",
  "input": {
    "aspect_ratio": "1:1",
    "background": "auto",
    "image_urls": [
      "https://example.com/reference.png"
    ],
    "output_format": "png",
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "resolution": "2k"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Wygenerowane ze schematu wejścia tego modelu – tego samego, względem którego API waliduje każde żądanie.

Parametry wejściowe

Te pola umieść w obiekcie input w ciele żądania. Nazwy i typy odpowiadają API. Gdy wartości domyślnej nie podano, nie zakładaj żadnej.

image_urlsarray<string>WymaganeWpływa na cenę

Przekazuje od 1 do 10 obrazów referencyjnych; źródło jest wymagane i żadne nie jest wybrane domyślnie. Ponumeruj je w instrukcji jako Image 1, Image 2 i kolejne. Każda referencja zwiększa opłatę, również pierwszy obraz.

Domyślnie: Nie określono
Ograniczenia: minItems:1
maxItems:10

promptstringWymagane

Podaj wymaganą instrukcję edycji; nie ma domyślnego tekstu. Limit wynosi 5000 znaków, a ByteDance zaleca nie przekraczać 600 słów po angielsku. Oznacz referencje jako Image 1 i Image 2 albo wskaż obszar za pomocą prostokątów, strzałek lub współrzędnych naniesionych na wejście. Treść instrukcji nie wpływa na opłatę.

Domyślnie: Nie określono
Ograniczenia: minLength:1
maxLength:5000

backgroundstringOpcjonalne

Określa tło: auto, transparent lub opaque; domyślnie auto. Wybierz transparent wraz z png, aby uzyskać kanał alfa. JPEG zawsze pozostaje nieprzezroczysty. To ustawienie nie wpływa na opłatę.

Domyślnie: "auto"
Dozwolone wartości: "auto""transparent""opaque"

output_formatstringOpcjonalne

Wybiera kodowanie png lub jpeg; domyślnie png. Kodowanie nie wpływa na opłatę. Aby zachować przezroczystość, pozostaw png; wynik jpeg jest nieprzezroczysty.

Domyślnie: "png"
Dozwolone wartości: "png""jpeg"

resolutionstringOpcjonalneWpływa na cenę

Wybiera rozliczany próg rozdzielczości: 1k, 1.5k, 2k lub 4k; domyślnie 2k. Wpływa na opłatę, przy jednakowej stawce dla 1k i 1.5k.

Domyślnie: "2k"
Dozwolone wartości: "1k""1.5k""2k""4k"

aspect_ratiostringOpcjonalne

Ustala proporcje obrazu wynikowego: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 lub 21:9. Domyślnie 1:1. Zmiana tego ustawienia nie wpływa na opłatę. Edytor nie przejmuje proporcji źródła, więc w razie potrzeby wybierz pasujący format.

Domyślnie: "1:1"
Dozwolone wartości: "1:1""4:3""3:4""16:9""9:16""3:2""2:3""21:9"

{
  "additionalProperties": false,
  "properties": {
    "aspect_ratio": {
      "default": "1:1",
      "description": "Output aspect ratio. It does not follow the input automatically, so pick the one that matches your image.",
      "enum": [
        "1:1",
        "4:3",
        "3:4",
        "16:9",
        "9:16",
        "3:2",
        "2:3",
        "21:9"
      ],
      "type": "string",
      "x-ui": {
        "order": 71,
        "widget": "select"
      }
    },
    "background": {
      "default": "auto",
      "description": "Background treatment. Transparent needs PNG output; a JPEG always stays opaque.",
      "enum": [
        "auto",
        "transparent",
        "opaque"
      ],
      "type": "string",
      "x-ui": {
        "order": 50,
        "widget": "radio"
      }
    },
    "image_urls": {
      "description": "Source images that you are authorised to process, up to ten. Each one adds a small charge.",
      "items": {
        "contentMediaType": [
          "image/jpeg",
          "image/png",
          "image/webp",
          "image/gif"
        ],
        "format": "uri",
        "type": "string"
      },
      "maxItems": 10,
      "minItems": 1,
      "type": "array",
      "x-ui": {
        "accept": [
          "image/*"
        ],
        "advanced": false,
        "affects_price": true,
        "order": 90,
        "widget": "multi-upload"
      }
    },
    "output_format": {
      "default": "png",
      "description": "File format of the returned image.",
      "enum": [
        "png",
        "jpeg"
      ],
      "type": "string",
      "x-ui": {
        "order": 60,
        "widget": "radio"
      }
    },
    "prompt": {
      "description": "Say what to change. Refer to the images as Image 1, Image 2 and so on.",
      "maxLength": 5000,
      "minLength": 1,
      "type": "string",
      "x-ui": {
        "order": 100,
        "primary": true,
        "reference_tokens": {
          "image_urls": "Image {index}"
        },
        "widget": "textarea"
      }
    },
    "resolution": {
      "default": "2k",
      "description": "Output resolution tier.",
      "enum": [
        "1k",
        "1.5k",
        "2k",
        "4k"
      ],
      "type": "string",
      "x-ui": {
        "affects_price": true,
        "order": 65,
        "widget": "radio"
      }
    }
  },
  "required": [
    "prompt",
    "image_urls"
  ],
  "type": "object",
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": [
      "resolution"
    ]
  }
}

Śledź zadanie

HTTP 202 oznacza, że zadanie zostało przyjęte, a nie ukończone. Zapisz zwrócone taskId i odpytuj właśnie to zadanie. Nie twórz kolejnego zadania, czekając na jego wynik.

Odpowiedź o przyjęciu

HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_create",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued",
    "estimatedCost": "0.750000"
  }
}

Odpowiedź o przyjęciu zawiera szacunek, dzięki czemu twoja aplikacja pokaże tę samą kwotę w historii zadań i w rozliczeniach.

Odczytaj zadanie

curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
  --data-urlencode "taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Zacznij odpytywać mniej więcej co 2 sekundy i stopniowo wydłużaj odstęp. Zatrzymaj się na stanie końcowym. Po zerwaniu połączenia odpytaj pierwotne taskId. Tworzenie ponawiaj wyłącznie z pierwotnym kluczem idempotentności i pierwotnym ciałem żądania.

Albo odbierz wynik przez callback

import { verifyWebhook } from "@spicyapi/sdk";

// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
  const { payload } = verifyWebhook({
    rawBody: req.body,
    timestamp: req.header("X-Webhook-Timestamp"),
    signature: req.header("X-Webhook-Signature"),
    payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
    secret: process.env.SPICY_WEBHOOK_SECRET,
  });
  res.status(200).end();
  void handleFinishedTask(payload);
});

Podaj callBackUrl przy tworzeniu zadania, a gotowy rekord przyjdzie do ciebie metodą POST – bez żadnej pętli odpytywania. Każda dostawa niesie X-Webhook-Timestamp, X-Webhook-Signature i X-Webhook-Payload-Version. Podpis to HMAC-SHA256 w base64 z taskId.timestamp.sha256(body), więc trzeba go sprawdzać na surowych bajtach: sparsowanie JSON-a i ponowne zserializowanie zmienia je i weryfikacja się nie powiedzie. Nieudane dostawy są ponawiane, więc to samo taskId może przyjść dwa razy – zrób obsługę idempotentną. Najpierw odpowiedz kodem 2xx, a pracę wykonaj potem; wolna obsługa jest traktowana jak nieudana dostawa.

Odczytaj wynik

Wynik wykorzystuj dopiero przy stanie succeeded. Przy niepowodzeniu skorzystaj z errorCode, errorMessage i request_id. Przykładowe koszty i stany nie odpowiadają rzeczywistemu rozliczeniu.

Przykład odpowiedzi po zakończeniu

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_record",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "bytedance/seedream-5.5/edit",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.png",
          "mime": "image/png",
          "url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.png?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
          "expiresAt": "2026-08-28T12:20:08.000Z"
        }
      ]
    },
    "cost": "0.750000",
    "settled": true,
    "createdAt": "2026-08-28T12:00:00Z",
    "completedAt": "2026-08-28T12:00:30Z"
  }
}

Każdy dostępny materiał otwieraj lub pobieraj bezpośrednio spod assets[].url, bez nagłówka Authorization. Podpisany adres wygasa o expiresAt; odpytaj zadanie ponownie, żeby go odświeżyć, dopóki materiał mieści się w okresie przechowywania. Materiał oczekujący lub niedostępny nie ma adresu. Podpisane adresy traktuj jako prywatne.

SDK i integracje

Korzystaj ze SpicyAPI w aplikacji, terminalu, asystencie AI lub wizualnym przepływie pracy. Wybierz instrukcję konfiguracji.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Polecenia terminala i skrypty automatyzacji.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instrukcje wielokrotnego użytku dla asystenta AI.

n8n

Węzły społecznościowe dla instalacji self-hosted i szablony HTTP Request do importu w n8n Cloud.

ComfyUI

Przepływy obrazów, wideo i dźwięku na płótnie węzłów.

Więcej integracji

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Przeglądaj gotowe przepływy pracy

Nie musisz pisać żadnego z powyższych fragmentów kodu. Wystarczy raz podłączyć serwer MCP, a każdy agent obsługujący MCP — Claude Code, Codex, Cursor, Windsurf, VS Code, Gemini CLI, Cline, LibreChat — może uruchomić ten model po nazwie. Można go też wywołać z powłoki jednym poleceniem.

Powiedz to swojemu agentowi

Użyj bytedance/seedream-5.5/edit, żeby poprawić ./poster.png – cieplejsze światło, czystsze tło – i zapisz wynik obok pliku źródłowego.

Agent znajduje model w aktualnym katalogu, sam wysyła plik lokalny, a potem pokazuje dokładną wycenę wraz z maksymalną opłatą i czeka na twoje potwierdzenie. Nic nie zostaje naliczone, dopóki nie zgodzisz się wprost.

Podłącz raz

claude mcp add spicyapi -e SPICY_API_KEY=$SPICY_API_KEY \
  -- npx --yes --package=@spicyapi/mcp spicyapi-mcp
npx skills add spicyapi-ai/spicy-skill

Pierwsza linia daje agentowi narzędzia; druga daje mu Skill, czyli reguły ich używania: najpierw wycena, potem opłata, wysyłanie plików lokalnych zamiast wklejania bajtów i odczyt gotowego adresu materiału zamiast zgadywania. Każdy inny klient podłącza ten sam serwer przez własny plik konfiguracyjny – zobacz centrum dla deweloperów.

Albo jedno polecenie w powłoce

npx @spicyapi/cli tasks create --model bytedance/seedream-5.5/edit \
  --input-json '{"aspect_ratio":"1:1","background":"auto","image_urls":["https://example.com/reference.png"],"output_format":"png","prompt":"A ceramic teapot on a linen cloth, soft window light, muted palette","resolution":"2k"}' \
  --wait

Wejściem jest własny schemat tego endpointu, ten sam co w przykładach powyżej. --wait odpytuje aż do zakończenia zadania i wypisuje wynik; dodaj --yes, żeby pominąć pytanie o potwierdzenie w CI. Najpierw ustaw SPICY_API_KEY – jeden klucz działa w API, w CLI i na serwerze MCP.

Jak długo przechowujemy wyniki

npx @spicyapi/cli tasks create --model bytedance/seedream-5.5/edit \
  --input-json '{…}' --retention 1h --wait

npx @spicyapi/cli tasks get $TASK_ID   # read back the retention that applied

--retention potrafi wyłącznie skrócić okno – 30m, 1h, 7d albo 0, żeby usunąć zaraz po osiągnięciu przez zadanie stanu końcowego. Obowiązuje najkrótsza z trzech wartości: twojego żądania, ustawień konta i maksimum platformy, więc odczytaj ją z rekordu zadania, zamiast zakładać, że podana liczba zadziałała. Podanie okna dłuższego, niż pozwala konto, nic nie zmienia.

Użyj w ComfyUI

Zainstaluj węzły SpicyAPI przez ComfyUI Manager albo poleceniem poniżej, a potem wyszukaj na płótnie Seedream 5.5 · Image Editing. Węzeł ma te same opcje co ta strona i pokazuje cenę, zanim ruszy.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Przykładowe workflowy Poradnik konfiguracji Kod źródłowy na GitHubie

Osadzony panel czyta ten sam schemat co ta strona, więc nie może się od API rozjechać. Jeśli twoja dokumentacja potrzebuje treści przeszukiwalnej, pobierz JSON spod /api/embed/models/ i wyrenderuj go samodzielnie.

<iframe src="https://spicyapi.ai/embed/pl/models/seedream-5-5/api?model=bytedance%2Fseedream-5.5%2Fedit" width="100%" height="560" loading="lazy" title="Przykładowe żądanie" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Otwórz panel

Obszar roboczy

Wyślij żądanie

Uwierzytelnianie API

Parametry wejściowe

Śledź zadanie

Odczytaj wynik

SDK i integracje

Użyj w ComfyUI