img2threejs公開｜画像から3Dコードを生成

1枚の画像から3Dモデルを作る手法に、新しい選択肢が登場しました。オープンソースの「img2threejs」は、画像をメッシュファイルへ変換するのではなく、ブラウザで動くThree.jsのコードとして対象物を再構築します。

XではCodexと組み合わせた制作例が注目されています。ただし、これはCodexの公式新機能ではありません。CodexなどのAIエージェントから呼び出して使う独立したプロジェクトです。本記事では、公式GitHubとリリース情報をもとに、仕組み、企業用途、導入時の注意点を整理します。

img2threejsとは何か

img2threejsは、参照画像に写った物体を、手続き型のThree.jsモデルとして再構築するオープンソースソフトウェア（OSS）です。Three.jsは、Webブラウザで3D表現を扱うためのJavaScriptライブラリです。

公式READMEによると、出力はTypeScriptで書かれたTHREE.Groupのファクトリーです。箱、球、押し出し形状などのプリミティブ、生成ジオメトリ、手続き型シェーダーを組み合わせます。完成物は固定された塊ではなく、回転軸、接続点、当たり判定などを持たせられます。

公式GitHubは2026年7月15日に作成され、7月25日19時台の確認時点で4,312スター、321フォークを集めていました。短期間での反応の大きさは、「コードで管理できる3D」への開発者の関心を示しています。

画像から3Dコードを作る仕組み

img2threejsは、一度の生成で完成を狙いません。仕様化、段階的な生成、レンダー比較、修正を繰り返します。AIにすべてを自由生成させるのではなく、Pythonスクリプトで各工程を検証する設計です。

公式が示す主な流れは次のとおりです。

1. 参照画像が3D化に適するかを確認する
2. 物体の種類、複雑さ、必要な品質を評価する
3. 部品、材質、接続点をJSON仕様へ落とし込む
4. 仕様が浅すぎないかを検証する
5. 形状、材質、表面、照明、動作を段階的に生成する
6. 参照画像とブラウザのレンダーを並べて視覚評価する
7. 基準未達なら仕様またはコードを修正する

この分業により、AIモデルは画像の判断とコード生成に集中できます。ファイル検証や工程管理は決定的なスクリプトが担うため、同じ確認をAIへ何度も依頼する必要が減ります。

2026年7月23日公開のv1.3では、参照画像からのグラデーション抽出、CIEDE2000による知覚的な色差計算、InstancedMeshによる反復形状の描画効率改善などが追加されました。開発は速い一方、仕様変更も続く初期段階だと理解しておく必要があります。

Codexと組み合わせると何が変わるか

Codexを使う価値は、画像の分析からブラウザ確認、コード修正までを会話で反復できる点にあります。CodexはOpenAIが提供するコーディングエージェントで、リポジトリ内のファイルを読み、コードの作成や修正、コマンド実行を支援します。

想定される作業は次のとおりです。

• 参照画像の形状、材質、色を分析する
• img2threejsの仕様ファイルを生成する
• Three.jsコードを出力し、ブラウザでプレビューする
• 参照画像との差を確認し、部品単位で修正する
• 最終コードをGitへ保存し、レビューを受ける

Xでは、この反復作業が自然言語で進められる点が紹介され、直近12時間の集計で114いいね、10リポストを記録しました（出典投稿）。一方、公式READMEはCodexだけでなく、Claude CodeとOpenCodeにも対応すると説明しています。組織は特定モデルを前提にせず、既存の開発環境、権限管理、費用に合うエージェントを選べます。

AIコーディングエージェント全体の選び方は、AIコーディングツール完全ガイドも参考にしてください。

3D生成を含むAI活用について、「どの業務から検証するか」「品質基準をどう置くか」を整理したい企業向けに、株式会社Nexaが導入計画の策定を支援しています。

AI顧問の詳細・無料相談はこちら →

企業で検討できる4つの用途

img2threejsは、完成品の3D制作を直ちに置き換えるより、試作と反復の速度を上げる用途に向いています。

Webサイトの3D演出

製品ページや採用サイトに置く回転モデル、アイソメトリック素材、キャンペーン用の3D部材を試作できます。出力がThree.jsコードなので、Webアプリへの組み込みまで同じ開発環境で進めやすい点が利点です。

ゲームや展示コンテンツのプロトタイプ

ゲーム内の小物、展示会のデジタル展示、教育コンテンツの模型を短時間で作り、企画段階の確認に使えます。公式ギャラリーでは、イヤホン、建物、宝箱などの作例とソースコードが公開されています。

Gitを使った共同レビュー

TypeScriptとJSONが成果物なので、「形状のどこを変更したか」をプルリクエストで確認できます。デザイナーの視覚評価と、開発者のコードレビューを同じ変更単位へ集約しやすくなります。

再利用可能な3D部材の整備

ボタン、筐体、展示什器などを部品単位で定義すれば、色や寸法を変えて別コンテンツへ再利用できます。単発の画像生成ではなく、保守可能な部材として蓄積できるかが企業利用の判断軸です。

導入前に確認すべき限界とリスク

1枚の画像だけでは、隠れた面、奥行き、内部構造を正確に知ることはできません。公式も、見えない面を推定するため、完全な形状や100%の類似性は保証できないと明記しています。特に人物は、現時点では写実的な再現より、スタイル化した再構築に向きます。

企業では、次の4点を事前に確認してください。

「画像から生成できる」は、「設計データとして使える」を意味しません。寸法精度や安全性が求められる製造、医療、建築用途では、専門ソフトと専門家による検証が必要です。

日本企業が試すための3ステップ

1. 低リスクの対象を選ぶ

最初の対象は、Webページの装飾、小物、社内デモなど、誤差が安全性へ影響しないものに限定します。権利処理済みで、正面と輪郭が明瞭な画像を選ぶと比較しやすくなります。

2. 合格基準を先に決める

「似ている」という感想だけでは評価がぶれます。シルエット、主要色、部品数、ブラウザの描画速度、修正時間など、5項目程度の基準を決めます。従来制作との工数差も記録してください。

3. 人が承認する運用にする

AIエージェントが修正を反復しても、公開判断は人が行います。入力画像、生成コード、プレビュー、承認者を同じチケットやプルリクエストへ残せば、後から変更理由を追跡できます。

よくある質問

Q. img2threejsはCodexの公式機能ですか？

いいえ。img2threejsはApache License 2.0で公開された独立のOSSです。Codex、Claude Code、OpenCodeなどのAIエージェントから利用できます。

Q. Blenderの代わりになりますか？

用途は重なりますが、全面的な代替ではありません。Web用の小物や試作には向きますが、精密なモデリング、複雑なリギング、制作工程全体ではBlenderなどの専門ツールが必要です。

Q. 商用利用できますか？

リポジトリはApache License 2.0で公開されています。ただし、入力画像、再現する製品、キャラクターの権利は別に確認が必要です。企業利用では法務担当者と利用条件を確認してください。

Q. 導入に必要な環境は何ですか？

公式のスクリプトはPython 3.10以上の標準ライブラリで動作すると説明されています。生成物を確認するため、Three.jsを表示できるWeb開発環境と、画像を扱えるAIエージェントが必要です。

まとめ

img2threejsは、画像から3Dの見た目を再現するだけでなく、成果物を編集可能なTypeScriptコードとして残します。Gitで差分を追い、AIエージェントと人が同じ成果物を反復改善できる点が、従来の画像3D化との違いです。

現時点では、単一画像による推定誤差と、開発初期の変更速度を考慮する必要があります。企業はWeb用の小物など低リスクな対象を選び、品質基準と人の承認工程を置いた小規模PoCから始めるのが現実的です。

画像・3D生成AIの業務導入を支援します

株式会社Nexaでは、生成AIとAIエージェントを企業業務へ組み込むための検証設計、ツール選定、運用ルール整備を支援しています。導入テーマが定まっていない段階からご相談いただけます。

AI顧問の詳細・無料相談はこちら →