Χρησιμοποιήστε το Recraft Remove Background μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου recraft-remove-background, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.

Διαθέσιμο μέσω APIΕτοιμότηταΕικόνα

ID μοντέλου API

recraft-remove-background

Είσοδοι

file

Files API

Απαιτείται για λειτουργίες αναφοράς

Βασικές πιστώσεις

per_image · default=1 · ⌈total⌉

Δυνατότητα

Εικόνα

Χρέωση

FIXED

Όριο prompt

Δεν υπάρχει τεκμηριωμένο όριο prompt

Σύμβαση αιτήματος

Στείλτε το αναγνωριστικό μοντέλου στο ανώτερο επίπεδο. Οι έλεγχοι που είναι ειδικοί για το μοντέλο ανήκουν στο params.

Κλειδί	Τύπος	Υποχρεωτικό	Προεπιλογή	Περιγραφή
model	string	Ναι	recraft-remove-background	Χρησιμοποιήστε το recraft-remove-background ως αναγνωριστικό μοντέλου API.
prompt	string	Όχι	-	Κείμενο προτροπής για μοντέλα που υποστηρίζουν είσοδο κειμένου.
params	object	Όχι	-	Αντικείμενο παραμέτρων ειδικό για το μοντέλο. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα κλειδιά.
client_request_id	string	Όχι	-	Προαιρετικό client-side id για ιχνηλάτηση αιτημάτων στο δικό σας σύστημα.

Παράμετροι μοντέλου

Αυτό το μοντέλο δεν απαιτεί επιπλέον params πέρα από model, prompt και προαιρετικό client_request_id.

Πολιτική μεταφόρτωσης

Ανεβάστε πρώτα αρχεία αναφοράς και μετά τοποθετήστε το URL που επιστράφηκε και το duration token μέσα στο params.referenceMediaItems.

Κανόνας αναφοράς

Εικόνα πηγής: Ανεβάστε ακριβώς 1 εικόνα JPG, PNG ή WebP, έως 5 MB και 16 MP· κάθε διάσταση πρέπει να είναι 256–4096 px.

Μέγιστος αριθμός αρχείων

Αποδεκτοί τύποι αρχείων

image

Token διάρκειας

Οι αναφορές βίντεο και ήχου πρέπει να μεταφέρουν `durationToken` από το /api/v1/files όταν απαιτείται επαλήθευση διάρκειας.

kind	Μέγιστο μέγεθος	MIME types
image	5 MB	image/jpeg, image/png, image/webp

Ελάχιστο αίτημα

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

Αίτημα με αρχείο αναφοράς

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

Απόκριση δημιουργίας

Το τελικό σημείο δημιουργίας επιστρέφει δημόσιο αναγνωριστικό εργασίας. Ελέγχετε περιοδικά το τελικό σημείο κατάστασης μέχρι η εργασία να ολοκληρωθεί με επιτυχία ή να αποτύχει.

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

Συνηθισμένα σφάλματα

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Ορισμένες λειτουργίες απαιτούν μεταφορτώσεις αναφοράς μέσω Files API.

Ενσωμάτωση API για Recraft Remove Background