Jyaan AI Reference
Object editing
Object Import Format Version: 1
外部AIにオブジェクトを設計させるための公式仕様です。生成されたJSONをオブジェクト編集画面の 「貼り付け」から追加または置き換えできます。貼り付け時点では未保存のため、内容を確認してから保存してください。
Machine-readable endpoints
- /docs/ai/objects.md — この仕様のMarkdown版
- /ai/object-schema.json — JSON Schema
- /ai/catalog.json — 公開素材の最新JSON（キャッシュなし）
- /docs/ai/catalog.md — 公開素材の最新Markdown（キャッシュなし）
Output rules
- 出力は有効なJSONだけにし、コメントや説明文をJSON内部へ含めないこと。
- types[].idはこのJSON内で一意な、人間が読みやすいIDにすること。保存時にJyaanがUUIDへ変換する。
- 同じJSON内のタイプを複合オブジェクトの子にする場合はtypeRef、公開カタログ内の既存タイプを再利用する場合はpublicTypeIdを使うこと。
- publicTypeIdは /ai/catalog.json に現在掲載されているIDだけを使用すること。推測でIDを作らないこと。
- position・rotation・scaleは[x, y, z]。位置とサイズはメートル、回転は度で指定すること。
- shapeがmodelの場合はmodelUrl、web-screenの場合は表示するURLをmodelUrlに指定すること。
- 貼り付けは未保存ドラフトに反映される。サーバーへ直接書き込む公開APIではない。
Complete example
{
"version": 1,
"object": {
"name": "案内標識",
"description": "支柱と看板を組み合わせた案内用オブジェクト",
"tags": [
"道路",
"その他"
],
"types": [
{
"id": "post",
"name": "支柱",
"shape": "cylinder",
"size": {
"x": 0.12,
"y": 2.2,
"z": 0.12
},
"primitiveFaces": {
"side": {
"value": "#777777",
"offsetX": 0,
"offsetY": 0,
"scaleX": 1,
"scaleY": 1
}
}
},
{
"id": "board",
"name": "看板",
"shape": "box",
"size": {
"x": 1.8,
"y": 0.7,
"z": 0.08
},
"boxFaces": {
"front": [
[
"#2563eb"
]
],
"back": [
[
"#2563eb"
]
]
}
},
{
"id": "main",
"name": "標準",
"shape": "composite",
"children": [
{
"name": "支柱",
"typeRef": "post",
"position": [
0,
1.1,
0
]
},
{
"name": "看板",
"typeRef": "board",
"position": [
0,
2.05,
0
]
}
]
}
]
}
}Live public catalog
LiveGenerated at: 2026-09-28T16:50:06.763Z
以下の内容は静的なコピーではありません。公開シーンまたはオブジェクトの保存・更新後、次のアクセスで最新内容が表示されます。
Scenes
2
Objects
32
Textures
52
Public scene templates
コーヒー店
f493d641-ff4f-420e-8f21-529136f5dfbc
5 objects
コーヒー店
f493d641-ff4f-420e-8f21-529136f5dfbc
{
"id": "f493d641-ff4f-420e-8f21-529136f5dfbc",
"name": "コーヒー店",
"description": "{\"icon\":\"IconCoffee\",\"color\":\"#374151\"}",
"thumbnailUrl": null,
"objects": [
{
"id": "ff68980c-30f1-4f45-aff8-d78d7778ee57",
"name": "背景",
"type": "background",
"color": "#d1d5db",
"actions": [
{
"id": "8c73bdb5-8bad-4704-af6f-095c11e9accb",
"objectId": "ff68980c-30f1-4f45-aff8-d78d7778ee57",
"settings": {
"color": "#d1d5db",
"scale": [
1,
1,
1
],
"position": [
0,
0,
0
],
"rotation": [
0,
0,
0
],
"gradientDirection": 180
},
"keyframes": [],
"actionType": "builtin-init",
"orderIndex": 0
}
],
"visible": true,
"folderId": null,
"isPinned": false,
"keyframes": [
{
"time": 0,
"scale": [
1,
1,
1
],
"position": [
0,
0,
0
],
"rotation": [
0,
0,
0
],
"properties": {
"color": "#d1d5db",
"gradientDirection": 180
},
"childOverrides": []
}
],
"properties": {
"isStudioObject": true
},
"loopActions": false,
"isStudioObject": true,
"infiniteLoopDuration": 0,
"loopSingleCycleDuration": 0
},
{
"id": "16611c3e-fabc-470d-a657-c24cc9f019c8",
"name": "明るさ",
"type": "brightness",
"color": null,
"actions": [
{
"id": "33a9abd4-e005-49ff-8813-9fd65585eb61",
"objectId": "16611c3e-fabc-470d-a657-c24cc9f019c8",
"settings": {
"scale": [
1,
1,
1
],
"position": [
0,
0,
0
],
"rotation": [
0,
0,
0
]
},
"keyframes": [],
"actionType": "builtin-init",
"orderIndex": 0
}
],
"visible": true,
"folderId": null,
"isPinned": false,
"keyframes": [
{
"time": 0,
"scale": [
1,
1,
1
],
"position": [
0,
0,
0
],
"rotation": [
0,
0,
0
],
"properties": {},
"childOverrides": []
}
],
"properties": {
"isStudioObject": true
},
"loopActions": false,
"isStudioObject": true,
"infiniteLoopDuration": 0,
"loopSingleCycleDuration": 0
},
{
"id": "b58baab8-7cb7-4094-b1c4-b49ac49268ec",
"name": "部屋",
"type": "custom3d",
"color": null,
"actions": [
{
"id": "b3738dd3-c9d1-4cbe-8591-153d842808b5",
"objectId": "b58baab8-7cb7-4094-b1c4-b49ac49268ec",
"settings": {
"scale": [
1,
1,
1
],
"position": [
0,
0,
0
],
"rotation": [
0,
0,
0
]
},
"keyframes": [],
"actionType": "builtin-init",
"orderIndex": 0
}
],
"visible": true,
"folderId": null,
"isPinned": false,
"keyframes": [
{
"time": 0,
"scale": [
1,
1,
1
],
"position": [
0,
0,
0
],
"rotation": [
0,
0,
0
],
"properties": {},
"childOverrides": []
}
],
"properties": {
"typeId": "c71b6897-bde0-4a0c-90f3-be0bbbe2225b",
"templateId": "77bf6243-1aac-4b08-89ef-e9625ba983b8",
"templateName": ""
},
"loopActions": false,
"isStudioObject": false,
"infiniteLoopDuration": 0,
"loopSingleCycleDuration": 0
},
{
"id": "b072c04a-eade-495f-b52e-96e2e4eef85b",
"name": "ベースキャラクター",
"type": "character",
"color": null,
"actions": [
{
"id": "e3d244e5-1032-458b-8c64-b6e374fa35b4",
"objectId": "b072c04a-eade-495f-b52e-96e2e4eef85b",
"settings": {
"scale": [
1,
1,
1
],
"position": [
0,
0,
0
],
"rotation": [
0,
0,
0
]
},
"keyframes": [],
"actionType": "builtin-init",
"orderIndex": 0
}
],
"visible": true,
"folderId": null,
"isPinned": false,
"keyframes": [
{
"time": 0,
"scale": [
1,
1,
1
],
"position": [
0,
0,
0
],
"rotation": [
0,
0,
0
],
"properties": {},
"childOverrides": []
}
],
"properties": {
"modelUrl": "https://otnrraoiaibitgzjmfef.supabase.co/storage/v1/object/public/models/characters/f206ecd1-ad0b-4c19-a438-1051f7f3f626/8ed1d13b-853a-4e36-9f55-e668f351c60f.glb",
"motionId": "idle",
"characterId": "8ed1d13b-853a-4e36-9f55-e668f351c60f",
"expressionId": "neutral",
"defaultAnimation": "Emote_Idle_Talk"
},
"loopActions": false,
"isStudioObject": false,
"infiniteLoopDuration": 0,
"loopSingleCycleDuration": 0
},
{
"id": "36c2ad8e-c6ad-445f-b174-1f0387e339cf",
"name": "カメラ",
"type": "camera",
"color": null,
"actions": [
{
"id": "107adeda-dd53-42a2-8086-d615806cde6a",
"objectId": "36c2ad8e-c6ad-445f-b174-1f0387e339cf",
"settings": {
"scale": [
1,
1,
1
],
"cameraOn": true,
"position": [
0,
0,
0
],
"rotation": [
0,
0,
0
]
},
"keyframes": [],
"actionType": "builtin-init",
"orderIndex": 0
}
],
"visible": true,
"folderId": null,
"isPinned": false,
"keyframes": [
{
"time": 0,
"scale": [
1,
1,
1
],
"position": [
0,
0,
0
],
"rotation": [
0,
0,
0
],
"properties": {
"cameraOn": true
},
"childOverrides": []
}
],
"properties": {
"fov": 75,
"lookAtTarget": [
0,
0,
0
]
},
"loopActions": false,
"isStudioObject": false,
"infiniteLoopDuration": 0,
"loopSingleCycleDuration": 0
}
],
"studioObjects": [],
"exposedFields": [],
"updatedAt": "2026-09-15T23:51:13.759+00:00"
}