Dokumentacja Rivya AI
Strony API modeli

Integracja API Seedream 5.0 Pro Layer Decomposition

Używaj Seedream 5.0 Pro Layer Decomposition przez Rivya Public API v1 z identyfikatorem modelu seedream-5-pro-layer-decomposition, obsługiwanymi wejściami, parametrami, regułami Files API, kredytami i przykładami odpowiedzi.

Dostępne przez APIGotowośćObraz
Identyfikator modelu API

seedream-5-pro-layer-decomposition

Wejścia

file

Files API

Wymagane dla trybów referencyjnych

Kredyty bazowe

per_image · 1K=7 · 1.5K=7 · 2K=14 · auto_reserve=14 · ⌈total⌉

Możliwość

Obraz

Rozliczenia

FIXED

Limit promptu

5000 znaków

Kontrakt żądania

Wyślij identyfikator modelu na najwyższym poziomie. Kontrolki specyficzne dla modelu należą do params.

KluczTypWymaganeDomyślnieOpis
modelstringTakseedream-5-pro-layer-decompositionUżyj seedream-5-pro-layer-decomposition jako identyfikatora modelu API.
promptstringNie-Maksymalnie 5000 znaków dla tego modelu.
paramsobjectNie-Obiekt parametrów specyficznych dla modelu. Dozwolone klucze znajdziesz w wierszach poniżej.
client_request_idstringNie-Opcjonalny identyfikator po stronie klienta do śledzenia żądań w Twoim systemie.

Parametry modelu

KluczTypWymaganeDomyślnieZakresOpcjeOpis
sizeselectNieauto-auto, 1K, 1.5K, 2KRozmiar wyniku
output_formatselectNiejpeg-jpeg, pngTo ustawienie określa format obrazu bazowego. Oddzielone warstwy są zwracane jako pliki PNG.

Zasady przesyłania

Najpierw prześlij pliki referencyjne, a potem umieść zwrócony URL i token czasu trwania w params.referenceMediaItems.

Reguła referencji

Obraz źródłowy: Prześlij dokładnie jeden plik PNG, JPEG, WebP, BMP, TIFF lub GIF o rozmiarze do 30 MB; formaty HEIC i HEIF nie są obsługiwane.

Maks. plików

1

Akceptowane rodzaje plików

image

Token czasu trwania

Referencje wideo i audio powinny zawierać durationToken z /api/v1/files, gdy wymagana jest weryfikacja czasu trwania.

kindMaks. rozmiarTypy MIME
image30 MBimage/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff

Żądanie minimalne

{
  "model": "seedream-5-pro-layer-decomposition",
  "params": {
    "size": "auto",
    "output_format": "jpeg"
  }
}

Żądanie z plikiem referencyjnym

{
  "model": "seedream-5-pro-layer-decomposition",
  "params": {
    "size": "auto",
    "output_format": "jpeg",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Odpowiedź tworzenia

Endpoint tworzenia zwraca publiczny identyfikator zadania. Odpytuj endpoint statusu, aż zadanie zakończy się powodzeniem albo błędem.

{
  "id": "task_seedream_5_pro_layer_decomposition_example",
  "status": "queued",
  "model": "seedream-5-pro-layer-decomposition",
  "reserved_credits": 7,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Typowe błędy

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Niektóre tryby wymagają przesłania materiałów referencyjnych przez Files API.