Utilisez Recraft Remove Background via Rivya Public API v1 avec le model id recraft-remove-background, les entrées prises en charge, les paramètres, les règles Files API, les crédits et des exemples de réponse.

Disponible via APIDisponibilitéImage

ID de modèle API

recraft-remove-background

Entrées

file

Files API

Requis pour les modes avec référence

Crédits de base

per_image · default=1 · ⌈total⌉

Capacité

Image

Facturation

FIXED

Limite de prompt

Aucune limite de prompt documentée

Contrat de requête

Envoyez l'ID du modèle au niveau supérieur. Les contrôles propres au modèle vont dans params.

Clé	Type	Obligatoire	Par défaut	Description
model	string	Oui	recraft-remove-background	Utilisez recraft-remove-background comme ID de modèle API.
prompt	string	Non	-	Texte de prompt pour les modèles qui prennent en charge l'entrée texte.
params	object	Non	-	Objet de paramètres propre au modèle. Consultez les lignes ci-dessous pour les clés autorisées.
client_request_id	string	Non	-	ID côté client facultatif pour tracer les requêtes dans votre système.

Paramètres du modèle

Ce modèle ne nécessite aucun paramètre supplémentaire au-delà de model, prompt et du client_request_id facultatif.

Règle d'importation

Importez d'abord les fichiers de référence, puis placez l'URL renvoyée et le durationToken dans params.referenceMediaItems.

Règle de référence

Image source: Importez exactement 1 image JPG, PNG ou WebP, de 5 Mo et 16 MP maximum ; chaque dimension doit être comprise entre 256 et 4096 px.

Nombre max. de fichiers

Types de fichier acceptés

image

Duration token

Les références vidéo et audio doivent inclure durationToken depuis /api/v1/files lorsqu'une vérification de durée est requise.

kind	Taille max.	Types MIME
image	5 MB	image/jpeg, image/png, image/webp

Requête minimale

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

Requête avec fichier de référence

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

Réponse de création

L'endpoint de création renvoie un ID de tâche public. Interrogez l'endpoint de statut jusqu'à ce que la tâche réussisse ou échoue.

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

Erreurs courantes

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Certains modes exigent des importations de référence via Files API.

Intégration API Recraft Remove Background