Gunakan Recraft Remove Background melalui Rivya Public API v1 dengan ID model recraft-remove-background, input disokong, parameter, peraturan Files API, kredit dan contoh respons.

Tersedia melalui APIKesediaanImage

ID model API

recraft-remove-background

Input

file

Files API

Diperlukan untuk mod rujukan

Kredit asas

per_image · default=1 · ⌈total⌉

Keupayaan

Image

Bil

FIXED

Had prompt

Tiada had prompt didokumenkan

Kontrak permintaan

Hantar ID model pada peringkat atas. Kawalan khusus model berada dalam params.

Kunci	Jenis	Wajib	Lalai	Penerangan
model	string	Ya	recraft-remove-background	Gunakan ID model API recraft-remove-background.
prompt	string	Tidak	-	Teks prompt untuk model yang menyokong input teks.
params	object	Tidak	-	Objek parameter khusus model. Gunakan baris di bawah untuk kunci yang dibenarkan.
client_request_id	string	Tidak	-	ID sisi klien pilihan untuk menjejak permintaan dalam sistem anda.

Parameter model

Model ini tidak memerlukan params tambahan selain model, prompt dan client_request_id pilihan.

Polisi muat naik

Muat naik fail rujukan dahulu, kemudian letakkan URL dan token durasi yang dikembalikan dalam params.referenceMediaItems.

Peraturan rujukan

Imej sumber: Muat naik tepat 1 imej JPG, PNG atau WebP, maksimum 5 MB dan 16 MP; setiap dimensi mestilah 256–4096 px.

Fail maksimum

Jenis fail diterima

image

Token durasi

Rujukan video dan audio patut membawa durationToken daripada /api/v1/files apabila pengesahan durasi diperlukan.

kind	Saiz maksimum	Jenis MIME
image	5 MB	image/jpeg, image/png, image/webp

Permintaan minimum

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

Permintaan fail rujukan

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

Respons cipta

Endpoint cipta mengembalikan ID tugasan awam. Semak endpoint status sehingga tugasan berjaya atau gagal.

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

Ralat biasa

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sesetengah mod memerlukan muat naik rujukan Files API.

Integrasi API Recraft Remove Background