Używaj Recraft Remove Background przez Rivya Public API v1 z identyfikatorem modelu recraft-remove-background, obsługiwanymi wejściami, parametrami, regułami Files API, kredytami i przykładami odpowiedzi.

Dostępne przez APIGotowośćObraz

Identyfikator modelu API

recraft-remove-background

Wejścia

file

Files API

Wymagane dla trybów referencyjnych

Kredyty bazowe

per_image · default=1 · ⌈total⌉

Możliwość

Obraz

Rozliczenia

FIXED

Limit promptu

Brak udokumentowanego limitu promptu

Kontrakt żądania

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

Klucz	Typ	Wymagane	Domyślnie	Opis
model	string	Tak	recraft-remove-background	Użyj recraft-remove-background jako identyfikatora modelu API.
prompt	string	Nie	-	Tekst promptu dla modeli obsługujących wejście tekstowe.
params	object	Nie	-	Obiekt parametrów specyficznych dla modelu. Dozwolone klucze znajdziesz w wierszach poniżej.
client_request_id	string	Nie	-	Opcjonalny identyfikator po stronie klienta do śledzenia żądań w Twoim systemie.

Parametry modelu

Ten model nie wymaga dodatkowych params poza model, prompt i opcjonalnym client_request_id.

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 1 obraz JPG, PNG lub WebP, maksymalnie 5 MB i 16 MP; każdy wymiar musi mieć 256–4096 px.

Maks. plików

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.

kind	Maks. rozmiar	Typy MIME
image	5 MB	image/jpeg, image/png, image/webp

Żądanie minimalne

{
  "model": "recraft-remove-background"
}

Żądanie z plikiem referencyjnym

{
  "model": "recraft-remove-background",
  "params": {
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Odpowiedź tworzenia

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

{
  "id": "task_recraft_remove_background_example",
  "status": "queued",
  "model": "recraft-remove-background",
  "reserved_credits": 1,
  "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.

Integracja API Recraft Remove Background