開発者API — 提供中

不動産画像API

バーチャルステージング、リノベーション、写真補正、昼から夕暮れ、アイテム除去、間取り図など、Roomagenのすべてのツールを、1つのジョブエンドポイントと1つのAPIキーで。各ツールはドキュメント化されています。ウェブフック付き非同期ジョブで、結果は通常20~60秒。アカウントでパックを購入した後の出力にはRoomagenのブランディングが付きません。

APIキーを取得
terminal — roomagen api
$ 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が実行するのと同じアイテム除去ツールによるものです。

Object removal input
input.jpg
Object removal result
✓ result.jpg · 26s

デモ用の作例:入力画像は当サイト用にAIで作成したもので、クライアントの写真ではありません。

チームがRoomagenを選ぶ理由

すべてのツール、1つのエンドポイント

ステージング、リノベーション、補正、昼から夕暮れ、除去、外観、間取り図はすべてPOST /v1/jobsで動き、各ツールのオプションは例とともにドキュメント化されています。ツールは1つのパラメータで切り替えます。

間取り図を2Dでも3Dでも

2Dの図面、スキャン、手描き図面のスマホ写真を送ると、家具ありまたは家具なしの3Dレンダリング、きれいに描き直した図面、色付けした図面、真上から見たマーケティング画像が返ってきます。

パック購入後はブランドなし

無料の50画像にはRoomagenのウォーターマークが入ります。これは構築とテストのためのものです。アカウントでパックを購入すると、残っている無料画像を含め、以降のレンダリングはRoomagenのブランディングなしで返されます。

安全なリトライ

Idempotency-Keyヘッダーを送ると、繰り返したリクエストは元のジョブを返します。二重課金も二重レンダリングもありません。

失敗したジョブは返金

生成中に失敗したジョブは自動的に返金されます。ウェブフックはHMACで署名され、約36分間に最大5回配信を試みます。

セルフサーブ、本物のドキュメント

開発者ポータルでキーを作成でき、営業との電話は不要です。cURL・Node.js・Pythonの例を備えた公開ドキュメント。結果はウェブフックまたはポーリングで受け取れます。

馴染みのある設計

ジョブを送信し、ジョブIDを受け取り、完了時にウェブフックを受信。1ジョブにつき1画像:ジョブは並行して実行でき、キーごとに毎分最大60件の新規ジョブを作成できます。

POST /api/v1/jobs
$ 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": [] }

シンプルなプリペイド料金

クレジットは画像数で計算されます。プリペイド式で、有効期限はありません。失敗した生成には課金されません。

カード登録不要

Developer

$0

ウォーターマーク付き50画像、初回のみ

最初のキーのみ

Pilot

$125

500画像

$0.25 / 画像

ポータルで購入

プリペイド · 有効期限なし

一番人気

Growth

$550

2,500画像

$0.22 / 画像

ポータルで購入

プリペイド · 有効期限なし

Scale

$2,000

10,000画像

$0.20 / 画像

ポータルで購入

プリペイド · 有効期限なし

コミット利用割引

Volume

カスタム

50,000画像以上

ご相談ください

価格は生成画像1枚あたり。4Kレンダリングは2枚分として数えます。アカウントでパックを購入した後のレンダリングにはRoomagenのブランディングは付きません。価格変更は30日前に通知します。

数分で稼働開始

キーを作成し、POSTを1回送るだけで、完成した画像が返ります。商談も順番待ちもありません。

roomagen-api — quickstartv1
  1. 1

    キーを作成

    開発者ポータルにサインインしてキーを生成します。表示は一度きりなので、安全な場所に保管してください。

    developers.roomagen.com/portal ↗
  2. 2

    最初のジョブを実行

    ツールのslugと画像を添えてPOSTを1回。応答はすぐにジョブ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. 3

    結果を受け取る

    webhook_urlを設定すれば、画像の完成時に呼び出します。ジョブのエンドポイントをポーリングすることもできます。通常20〜60秒です。

    POST → your webhook_urlGET /api/v1/jobs/{id}

✓ 最初のキーで50画像が無料(パック購入まではウォーターマーク付き) · カード登録不要

API FAQ

RoomagenのWebアプリにあるすべてのツールです:バーチャルステージング、部屋を空にする・片付ける、内装・外観のリノベーション、キッチンとバスルーム、写真編集、昼から夕暮れ、間取り図ツール。ジョブごとに1つのパラメータでツールを選択します。各ツールのオプションと例はdevelopers.roomagen.com/docs/toolsにまとめてあり、GET /v1/toolsはお使いのキーで呼び出せるすべてのスラッグを返します。

ジョブは通常20~60秒で完了します。バーチャルステージングとバーチャルリノベーションは、この範囲の上限寄りです。ジョブ完了時にウェブフックを受け取るか、2~5秒ごとにジョブをポーリングできます。

はい、アカウントでパックを購入した後のレンダリングにはRoomagenのブランディングもウォーターマークも付きません。それ以前に無料の50画像で作ったレンダリングには、構築・テスト用としてウォーターマークが入ります。APIはロゴや開示ラベルを追加しないため、掲載ルールで必要なラベルはご自身のパイプラインで追加してください。

生成中に失敗したジョブは自動的に返金され、errorフィールドに理由が示されます。完了したジョブは1回課金され、再実行は新しいジョブになります。

画像数で計算されるプリペイドパックです:500画像は$0.25、2,500画像は$0.22、10,000画像は$0.20、50,000画像超はコミット利用の交渉価格。4Kレンダリングは2画像分です。パックに有効期限はなく、残高に加算されます。

いいえ。ジョブが返すのは編集済み画像だけで、開示ラベル、変更内容の記録、オリジナルのコピーは含まれません。元の写真を保管し、MLSや現地の法律が求める場合は編集済み画像にラベルを付けてください。たとえばカリフォルニア州のAB 723は、開示文と未加工のオリジナルへのリンクを求めています。

Roomagenの出力を自社の製品やプラットフォームに組み込むことは、まさにこのAPIの目的です。生のAPIを自社のAPIとしてプロキシ提供するには再販契約が必要です — お問い合わせください。

はい — 最初のAPIキーを作成すると、初回のみ50画像分が無料でアカウントに追加され、カード登録は不要です。アカウントでパックを購入するまではRoomagenのウォーターマーク付きで生成されますが、ウェブフックを含むジョブの全工程をカバーするため、購入前に構築とテストができます。

物件画像で何かを作っていますか?

開発者ポータルでキーを作成し、今日のうちに最初のジョブを通してください。構築とテスト用に50画像が無料(パック購入まではウォーターマーク付き)、カード登録は不要です。

APIキーを取得