Recraft Remove Background modelini Rivya Public API v1 üzerinden model id recraft-remove-background, desteklenen girişler, parametreler, Files API kuralları, krediler ve yanıt örnekleriyle kullanın.

API üzerinden kullanılabilirHazırlıkGörsel

API model kimliği

recraft-remove-background

Girişler

file

Files API

Referans modları için gerekli

Temel krediler

per_image · default=1 · ⌈total⌉

Yetenek

Görsel

Faturalandırma

FIXED

Prompt limiti

Belgelenmiş prompt limiti yok

İstek sözleşmesi

Model id değerini en üst seviyede gönderin. Modele özel kontroller params içine aittir.

Anahtar	Tür	Gerekli	Varsayılan	Açıklama
model	string	Evet	recraft-remove-background	recraft-remove-background API model kimliği değerini kullanın.
prompt	string	Hayır	-	Metin girişini destekleyen modeller için prompt metni.
params	object	Hayır	-	Modele özel parametre nesnesi. İzin verilen anahtarlar için aşağıdaki satırları kullanın.
client_request_id	string	Hayır	-	Sisteminizde istekleri izlemek için isteğe bağlı istemci tarafı id.

Model parametreleri

Bu model, model, prompt ve isteğe bağlı client_request_id dışında ek params gerektirmez.

Yükleme politikası

Önce referans dosyalarını yükleyin, ardından dönen URLyi ve duration token değerini params.referenceMediaItems içine yerleştirin.

Referans kuralı

Kaynak görsel: Tam olarak 1 JPG, PNG veya WebP görsel yükleyin; en fazla 5 MB ve 16 MP, her kenar 256–4096 px olmalıdır.

Maks. dosya

Kabul edilen dosya türleri

image

Süre belirteci

Süre doğrulaması gerektiğinde video ve ses referansları /api/v1/files içinden durationToken taşımalıdır.

kind	Maks. boyut	MIME türleri
image	5 MB	image/jpeg, image/png, image/webp

Minimal istek

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

Referans dosyalı istek

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

Create yanıtı

Create endpointi herkese açık task id döndürür. Görev başarılı veya başarısız olana kadar status endpointini sorgulayın.

{
  "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
}

Yaygın hatalar

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Bazı modlar Files API referans yüklemeleri gerektirir.

Recraft Remove Background API Entegrasyonu