# Meshy 7 API Meshy 7 の 3D 生成モデルの完全な API リファレンス。 ## モデルの種類 | モデル | 説明 | | -------------------------- | -------------------------------------------------- | | `meshy-v7-text-to-3d` | テキストの説明から 3D モデルを生成します | | `meshy-v7-image-to-3d` | 1 枚の画像から 3D モデルを生成します | | `meshy-v7-multiview-to-3d` | 複数の参照画像から 3D モデルを生成します | ## エンドポイント ```text POST /api/v1/3d/task GET /api/v1/3d/{task_id} ``` ## Meshy 7 テキストから 3D を生成 ### 必須パラメータ | パラメータ | 型 | 説明 | | ------------ | ------ | -------------------------------------------- | | `model_name` | string | `meshy-v7-text-to-3d` を指定します | | `prompt` | string | 生成する 3D モデルのテキストによる説明。1～600 文字 | ### 任意のパラメータ | パラメータ | 型 | 説明 | | ------------------ | ------- | ---------------------------------------------------------------------- | | `topology` | string | リメッシュ後のトポロジー：`triangle` または `quad`。デフォルトは `triangle` | | `target_polycount` | integer | リメッシュ後の目標ポリゴン数。範囲：100～300000。デフォルトは 30000 | | `remesh` | boolean | メッシュを再生成するかどうか。デフォルトは `true` | | `symmetry_mode` | string | 対称性モード：`off`、`auto`、`on`。デフォルトは `auto` | | `pose_mode` | string | 人型モデルのポーズ：`a-pose` または `t-pose`。デフォルトではポーズを指定しません | | `pbr` | boolean | PBR マテリアルのテクスチャを生成するかどうか。デフォルトは `false` | | `texture_prompt` | string | テクスチャ生成の指示に使用するテキストの説明。最大 600 文字 | | `texture_image` | string | テクスチャ生成の指示に使用する参照画像の URL | | `seed` | integer | 乱数シード。デフォルトは `-1` で、ランダムな結果を生成します | ### リクエスト例 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/3d/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'meshy-v7-text-to-3d', prompt: 'A stylized red panda explorer wearing a small canvas backpack', topology: 'quad', remesh: true, symmetry_mode: 'auto', pose_mode: 'a-pose', pbr: true, texture_prompt: 'Hand-painted fur and weathered canvas with warm autumn colors', texture_image: 'https://example.com/red-panda-texture.png', }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Meshy 7 画像から 3D を生成 ### 必須パラメータ | パラメータ | 型 | 説明 | | ------------ | ------ | ------------------------------------------ | | `model_name` | string | `meshy-v7-image-to-3d` を指定します | | `image_url` | string | 公開アクセス可能な入力画像の URL | ### 任意のパラメータ | パラメータ | 型 | 説明 | | ------------------ | ------- | ---------------------------------------------------------------------- | | `topology` | string | リメッシュ後のトポロジー：`triangle` または `quad`。デフォルトは `triangle` | | `target_polycount` | integer | リメッシュ後の目標ポリゴン数。範囲：100～300000。デフォルトは 30000 | | `remesh` | boolean | メッシュを再生成するかどうか。デフォルトは `true` | | `symmetry_mode` | string | 対称性モード：`off`、`auto`、`on`。デフォルトは `auto` | | `pose_mode` | string | 人型モデルのポーズ：`a-pose` または `t-pose`。デフォルトは `a-pose` | | `pbr` | boolean | PBR マテリアルのテクスチャを生成するかどうか。デフォルトは `false` | | `texture_prompt` | string | テクスチャ生成の指示に使用するテキストの説明。最大 600 文字 | | `texture_image` | string | テクスチャ生成の指示に使用する参照画像の URL | ### リクエスト例 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/3d/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'meshy-v7-image-to-3d', image_url: 'https://example.com/ceramic-lamp.png', topology: 'triangle', remesh: true, symmetry_mode: 'auto', pose_mode: 'a-pose', pbr: true, texture_prompt: 'Glazed blue ceramic with subtle gold details', texture_image: 'https://example.com/ceramic-reference.png', }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Meshy 7 複数視点の画像から 3D を生成 ### 必須パラメータ | パラメータ | 型 | 説明 | | ------------ | -------- | ------------------------------------------------ | | `model_name` | string | `meshy-v7-multiview-to-3d` を指定します | | `images` | string[] | 1～4 個の参照画像 URL。視点の順序に指定はありません | ### 任意のパラメータ | パラメータ | 型 | 説明 | | ------------------ | ------- | ---------------------------------------------------------------------- | | `topology` | string | リメッシュ後のトポロジー：`triangle` または `quad`。デフォルトは `triangle` | | `target_polycount` | integer | リメッシュ後の目標ポリゴン数。範囲：100～300000。デフォルトは 30000 | | `remesh` | boolean | メッシュを再生成するかどうか。デフォルトは `true` | | `symmetry_mode` | string | 対称性モード：`off`、`auto`、`on`。デフォルトは `auto` | | `pose_mode` | string | 人型モデルのポーズ：`a-pose` または `t-pose`。デフォルトではポーズを指定しません | | `pbr` | boolean | PBR マテリアルのテクスチャを生成するかどうか。デフォルトは `false` | | `texture_prompt` | string | テクスチャ生成の指示に使用するテキストの説明。最大 600 文字 | | `texture_image` | string | テクスチャ生成の指示に使用する参照画像の URL | ### リクエスト例 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/3d/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'meshy-v7-multiview-to-3d', images: [ 'https://example.com/chair-front.png', 'https://example.com/chair-side.png', 'https://example.com/chair-back.png', ], topology: 'quad', remesh: true, symmetry_mode: 'auto', pbr: true, texture_prompt: 'Natural walnut wood and woven cream fabric', texture_image: 'https://example.com/chair-material-reference.png', }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## レスポンス形式 ### タスクの送信 ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/3d/{task_id}", "task_status": "submitted" } } ``` ### タスクステータスの照会 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/3d/{task_id}', { headers: { Authorization: 'Bearer YOUR_API_KEY' }, }); const { data } = await response.json(); console.log(data.task_status); ``` ### 完了したタスク ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/3d/{task_id}", "task_status": "succeed", "task_status_msg": null, "task_result": { "credit": 0.2, "files": [{ "url": "https://example.com/generated-model.glb" }] } } } ``` ### タスクステータスの値 - `submitted`: タスクが送信されました。 - `processing`: タスクを処理中です。 - `succeed`: タスクが正常に完了しました。 - `failed`: タスクが失敗しました。