房地产图像API
虚拟软装、翻新、照片增强、日转夜、物品移除、户型图以及Roomagen的其他所有工具——每个都有文档，全部通过一个任务端点和一把API密钥调用。带Webhook的异步任务，结果通常在20–60秒内返回；账户购买图片包后，输出不带Roomagen品牌。
$ 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": [] }
API背后工具的真实输出
这组前后对比来自物品移除工具，也就是API运行的同一个工具。
演示示例：输入图片由 AI 为本网站生成，并非客户照片。
按功能了解API
为什么团队选择Roomagen
所有工具，一个端点
软装、翻新、增强、日转夜、移除、外观和户型图都通过POST /v1/jobs运行，每个工具的选项都有文档和示例。用一个参数切换工具。
户型图，2D与3D
发送一张2D户型图、扫描件或手绘图的手机照片，即可得到带家具或空置的3D渲染、重新绘制的整洁户型图、上色户型图或俯视营销图。
购买图片包后无品牌
50张免费图片生成时带有Roomagen水印，用于构建和测试。账户购买图片包后，之后的每次渲染都不带Roomagen品牌，包括剩余的免费图片。
安全重试
发送Idempotency-Key请求头，重复的请求会返回原来的任务：不会二次扣费，也不会二次渲染。
失败任务自动退还
生成过程中失败的任务会自动退还。Webhook使用HMAC签名，约36分钟内最多投递5次。
自助开通，真实文档
在开发者门户创建密钥，无需销售通话。含cURL、Node.js和Python示例的公开文档；通过Webhook或轮询获取结果。
为熟悉感而设计
提交任务，拿到任务ID，完成时收到Webhook。每个任务一张图片：任务可并行运行，每把密钥每分钟最多创建60个新任务。
$ 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": [] }
几分钟即可跑通
创建密钥，发一个POST，拿回成品图。无需销售沟通，无需排队。
- 1
- 2
运行第一个任务
带上工具slug和你的图片发一个POST。响应会立即返回任务ID，生成在后台进行。
$ 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
获取结果
设置webhook_url，图片就绪时我们会回调你；也可以轮询任务接口。通常20–60秒。
POST → your webhook_urlGET /api/v1/jobs/{id}
✓ 首个密钥赠送50张免费图片（购买图片包前带水印） · 无需信用卡