Integrasi API Recraft Remove Background
Gunakan Recraft Remove Background melalui Rivya Public API v1 dengan id model recraft-remove-background, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.
recraft-remove-background
file
Diperlukan untuk mode referensi
Tarif kredit: 1 / gambar Biaya akhir tugas dibulatkan ke atas ke kredit utuh.
Gambar
FIXED
Tidak ada batas prompt terdokumentasi
Kontrak request
Kirim id model di level atas. Kontrol khusus model berada di params.
| Key | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
| model | string | Ya | recraft-remove-background | Gunakan recraft-remove-background sebagai id model API. |
| prompt | string | Tidak | - | Teks prompt untuk model yang mendukung input teks. |
| params | object | Ya | - | Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan. |
| client_request_id | string | Tidak | - | ID sisi klien opsional untuk melacak request di sistem Anda. |
Parameter model
Model ini tidak membutuhkan params tambahan selain model, prompt, dan client_request_id opsional.
Kebijakan unggahan
Unggah file referensi terlebih dahulu, lalu tempatkan URL dan duration token yang dikembalikan ke dalam params.referenceMediaItems.
Gambar sumber: Unggah tepat 1 gambar JPG, PNG, atau WebP, maksimal 5 MB dan 16 MP; setiap dimensi harus 256–4096 px.
1
image
Referensi video dan audio harus membawa durationToken dari /api/v1/files saat verifikasi durasi diperlukan.
| kind | Ukuran maksimum | Tipe MIME |
|---|---|---|
| image | 5 MB | image/jpeg, image/png, image/webp |
Tidak ada contoh Public API yang dapat dijalankan untuk model ini.
Request file referensi
{
"model": "recraft-remove-background",
"params": {
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}Response create
Endpoint create mengembalikan public task id. Poll endpoint status sampai tugas berhasil 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
}Error umum
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Beberapa mode membutuhkan unggahan referensi Files API.
