L'API Image Immobilier
Home staging virtuel, rénovation, amélioration photo, jour-crépuscule, suppression d'objets, plans d'étage et tous les autres outils Roomagen : chacun documenté, derrière un seul endpoint de jobs et une seule clé API. Jobs asynchrones avec webhooks, résultats généralement en 20 à 60 secondes, et aucun branding Roomagen sur la sortie une fois que votre compte a acheté un pack.
$ curl -X POST https://api.roomagen.com/api/v1/jobs \-H "X-Api-Key: rmg_live_..." \-H "Content-Type: application/json" \-d '{"tool": "virtual-staging","image_url": "https://example.com/empty-living-room.jpg","options": { "style": "scandinavian", "roomType": "living-room" },"webhook_url": "https://yourapp.com/hooks/roomagen"}'# → { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }
De vrais résultats des outils derrière l'API
Cette paire avant/après vient de la suppression d'objets, l'outil même que l'API exécute.
Exemple de démonstration : l'image d'entrée a été générée par IA pour ce site ; ce n'est pas une photo de client.
Explorer l'API par fonctionnalité
Pourquoi les équipes choisissent Roomagen
Tous les outils, un seul endpoint
Staging, rénovation, amélioration, jour-crépuscule, suppression, extérieurs et plans d'étage passent tous par POST /v1/jobs, et les options de chaque outil sont documentées avec un exemple. Vous changez d'outil avec un seul paramètre.
Plans d'étage, 2D et 3D
Envoyez un plan 2D, un scan ou une photo au téléphone d'un dessin à la main, et recevez un rendu 3D meublé ou vide, un plan redessiné au propre, un plan mis en couleur ou une image marketing en vue de dessus.
Sans marque dès l'achat d'un pack
Les 50 images gratuites sont rendues avec un filigrane Roomagen : elles servent à construire et à tester. Dès que votre compte achète un pack, chaque nouveau rendu revient sans branding Roomagen, y compris les images gratuites qu'il vous reste.
Des retries sans risque
Envoyez un en-tête Idempotency-Key et une requête répétée renvoie le job d'origine : pas de second débit, pas de second rendu.
Jobs échoués remboursés
Un job qui échoue pendant la génération est remboursé automatiquement. Les webhooks sont signés en HMAC, avec jusqu'à cinq tentatives de livraison sur environ 36 minutes.
Libre-service, vraie documentation
Créez une clé dans le portail développeur, sans appel commercial. Documentation publique avec exemples cURL, Node.js et Python ; récupérez les résultats par webhook ou par polling.
Conçue pour vous sembler familière
Soumettez un job, recevez un identifiant de job, puis un webhook à la fin du traitement. Une image par job : lancez des jobs en parallèle, jusqu'à 60 nouveaux jobs par minute et par clé.
$ curl -X POST https://api.roomagen.com/api/v1/jobs \-H "X-Api-Key: rmg_live_..." \-H "Content-Type: application/json" \-d '{"tool": "virtual-staging","image_url": "https://example.com/empty-living-room.jpg","options": { "style": "scandinavian", "roomType": "living-room" },"webhook_url": "https://yourapp.com/hooks/roomagen"}'# → { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }
Tarification prépayée simple
Les crédits sont libellés en images. Prépayés, et ils n'expirent jamais. Les générations échouées ne sont jamais facturées.
Developer
$0
50 images avec filigrane, une fois
première clé uniquement
Growth
$550
2,500 images
$0.22 / image
Prépayé · n'expire jamais
Prix par image générée ; un rendu 4K compte pour deux. Les rendus ne portent aucun branding Roomagen une fois que le compte a acheté un pack. Préavis de 30 jours avant tout changement de prix.
Opérationnel en quelques minutes
Créez une clé, envoyez un POST, récupérez l'image finie. Aucun appel commercial, aucune file d'attente.
- 1
Créez votre clé
Connectez-vous au portail développeur et générez une clé. Elle n'est affichée qu'une seule fois : conservez-la en lieu sûr.
developers.roomagen.com/portal ↗ - 2
Lancez votre premier job
Un POST avec le slug de l'outil et votre image. La réponse arrive immédiatement avec un identifiant de job — la génération tourne en arrière-plan.
$ curl -X POST https://api.roomagen.com/api/v1/jobs \-H "X-Api-Key: rmg_live_..." \-H "Content-Type: application/json" \-d '{ "tool": "virtual-staging","image_url": "https://example.com/photo.jpg","options": { "style": "scandinavian", "roomType": "living-room" } }'# → 201 { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] } - 3
Récupérez le résultat
Renseignez un webhook_url et nous vous appelons dès que l'image est prête, ou interrogez l'endpoint du job. En général 20 à 60 secondes.
POST → your webhook_urlGET /api/v1/jobs/{id}
✓ 50 images gratuites sur votre première clé, avec filigrane jusqu'à l'achat d'un pack · sans carte bancaire
FAQ de l'API
Vous construisez quelque chose avec des images de biens ?
Créez une clé dans le portail développeur et lancez votre premier job dès aujourd'hui. 50 images gratuites pour construire et tester (avec filigrane jusqu'à l'achat d'un pack), sans carte bancaire.
Obtenir votre clé API