Creative Lab — ランプ API

希望するランプシェードのテーマを説明するテキストプロンプト。image_urlが省略された場合に必須です。最大800文字。

ランプシェードの視覚的参照としてMeshyが使用するソース写真。textが省略された場合に必須です。現在、.jpg、.jpeg、.png、および.webp形式をサポートしています。

画像を提供する方法は2つあります：

• 公開アクセス可能なURL：インターネットからアクセス可能なURL。
• Data URI：画像のbase64エンコードされたData URI。Data URIの例：data:image/jpeg;base64,<your base64-encoded image data>。

image-to-3Dパスのための主題カテゴリのヒント。利用可能な値：

• character（デフォルト）— 単一のキャラクター/オブジェクトの主題（フィギュア、動物、マスコットなど）。
• landscape — 屋外シーン/パノラマの主題（山、都市景観、森など）。

text-to-3Dパスでは無視されます。

表示目的のためのオプションのタスク名。最大100文字。

trueに設定すると、プロトタイプ画像は背景が削除された透明なRGBA PNGとして返され、任意の背景に主題を合成できます。

リクエストが受け入れられませんでした。一般的な原因：

• パラメータが不足している：textまたはimage_urlのいずれか一方が必要です。
• 両方が提供された：textとimage_urlの両方を渡すことは拒否されます — それらは相互排他的です。
• 無効な画像形式：提供されたimage_urlがサポートされていない形式です（.jpg、.jpeg、.png、.webp）。
• 画像の寸法が範囲外：画像が小さすぎる、最大ファイルサイズを超えている、または最大ピクセル数を超えている。
• 到達不能なURL：image_urlをダウンロードできませんでした（404またはtimeout）。
• 無効なData URI：base64文字列が不正です。
• コンテンツがフラグされた：入力画像がNSFWまたは知的財産のモデレーションによってフラグされました。
• テキストが長すぎる：textが800文字を超えています。
• 無効なimage_subject：character / landscapeのいずれでもありません。

認証に失敗しました。APIキーを確認してください。

このタスクを実行するためのクレジットが不足しています。

レート制限を超えました。

この同じOpenAPIエンドポイントを介して作成されたプロトタイプタスクのタスクIDです。プロトタイプは同じAPIキーで作成され、SUCCEEDEDに達し、正確に1つの候補画像を生成している必要があります。

Webアプリを通じて作成されたプロトタイプタスクは受け入れられません — ビルドエンドポイントはPOST /openapi/creative-lab/lamp/v1/prototypeによって生成されたプロトタイプタスクのみを受け入れ、他のソースは404で拒否されます。

表示目的のためのオプションのタスク名です。最大100文字。

ランプシェードのバウンディングボックスの目標最大寸法（ミリメートル単位）。メッシュはフィットするように均一にスケーリングされます。範囲: [50, 400]。

中空ランプシェードの肉厚（ミリメートル単位）。範囲: (0, 10]。

プリントがベッドに座れるように上部を平らにするランプシェードの高さの割合。範囲: [1, 100]。

ランプシェードと一緒に生成するベースディスクを決定する光源フィクスチャープリセット。利用可能な値:

• bambu_mh001_60mm (デフォルト) — 互換性のある光源フィクスチャー用にサイズ調整された60 mmベースディスクを生成します。結果にはmodel_urls.base_stlが含まれます。
• none — フィクスチャーなし、ベースディスクなし。model_urls.base_stlは省略されます。

ランプシェードの中心に対するフィクスチャーカットアウトの水平X軸オフセット（ミリメートル単位）。light_source_preset ≠ noneのときのみ意味があります。範囲: [-80, 80]。

ランプシェードの底部に対するフィクスチャーカットアウトの垂直Z軸オフセット（ミリメートル単位）。範囲: [-80, 80]。

処理前にインポートされたメッシュに適用されるX軸周りの回転（度単位）。範囲: [-360, 360]。

処理前にインポートされたメッシュに適用されるY軸周りの回転（度単位）。範囲: [-360, 360]。

処理前にインポートされたメッシュに適用されるZ軸周りの回転（度単位）。範囲: [-360, 360]。

trueであり、output.formatがzipの場合、ランププロセッサのresult.json（測定されたメッシュメトリクスと解決されたオプションセットを含む）をバンドル内に含めます。output.formatがstlの場合は無視されます。

ビルドによって返されるアーティファクトバンドル。利用可能な値:

• stl (デフォルト) — ランプシェードをmodel_urls.lamp_stlとして返し、light_source_preset ≠ noneの場合はmodel_urls.base_stlも返します。
• zip — プロセッサが生成するすべてのアーティファクト（lamp.stl、オプションのbase.stl、オプションのresult.json）を1つのzipにパッケージし、model_urls.bundle_zipとして返します。

リクエストは受け入れられませんでした。一般的な原因:

• パラメータが不足しています: input_task_idが必要です。
• 無効なUUID: input_task_idが有効なUUIDではありません。
• 親が成功していません: 参照されたプロトタイプタスクがまだSUCCEEDEDに達していません。
• 候補がありません: プロトタイプタスクは成功しましたが、候補画像を生成しませんでした。
• オプションが範囲外です: optionsフィールドの1つが許可された範囲または列挙セットの外にあります。

認証に失敗しました。APIキーを確認してください。

このタスクを実行するためのクレジットが不足しています。

参照されたプロトタイプタスクが存在しない、別のユーザーに属している、またはWebアプリを通じて作成された（APIモードのプロトタイプタスクのみがビルドにチェーンされます）。

レート制限を超えました。

取得するランプタスクの一意の識別子。

キャンセルするランプタスクの一意の識別子。

タスクがすでに終了状態にあり、キャンセルできません。

タスクが存在しない、別のユーザーに属している、またはそのステージがURLパスと一致しません。

ストリームするランプタスクの一意の識別子。

prototype または build のいずれか。コレクションはURLと一致するステージのタスクのみを返します — /prototype を取得してもビルドタスクは返されず、その逆も同様です。

ページネーションのためのページ番号。

ページサイズの制限。最大許容数は 50 アイテムです。

ソートするフィールド。利用可能な値:

• +created_at: 作成時間で昇順にソート。
• -created_at: 作成時間で降順にソート。

タスクの一意識別子です。タスクIDにはkソート可能なUUIDを使用していますが、IDの形式については何も仮定しないでください。

タスクのタイプです。値はcreative-lab-lamp-prototypeです。

タスクが作成されたときに提供されたタスク名です。名前が提供されなかった場合は空文字列になります。

タスクのステータスです。可能な値はPENDING、IN_PROGRESS、SUCCEEDED、FAILED、CANCELEDのいずれかです。

タスクの進捗です。タスクがまだ開始されていない場合、このプロパティは0になります。タスクが成功した場合、これは100になります。

タスクが作成された時のタイムスタンプ（ミリ秒単位）です。

タスクが開始された時のタイムスタンプ（ミリ秒単位）です。タスクがまだ開始されていない場合、このプロパティは0になります。

タスクが終了した時のタイムスタンプ（ミリ秒単位）です。タスクがまだ終了していない場合、このプロパティは0になります。

タスク結果の有効期限のタイムスタンプ（ミリ秒単位）です。

先行タスクの数です。

失敗したタスクのエラー詳細です。完全なtask_errorオブジェクトの参照についてはエラーを参照してください。

このタスクで消費されたクレジットの数です。タスクステータスがPENDING、IN_PROGRESS、またはSUCCEEDEDの場合に存在します。FAILEDタスクの場合は0を返します（失敗時にはクレジットが返金されます）。

このプロトタイプタスクによって生成されたコンセプト画像候補のダウンロード可能なURLです。現在、APIは常に正確に1つの候補を返しますが、このフィールドは配列であるため、将来的な改訂で複数の候補を破壊的変更なしに表示できます。

タスクの一意の識別子。

タスクのタイプ。値はcreative-lab-lamp-buildです。

タスクが作成されたときに提供されたタスク名。名前が提供されなかった場合は空の文字列。

タスクのステータス。可能な値はPENDING、IN_PROGRESS、SUCCEEDED、FAILED、CANCELEDのいずれかです。

タスクの進行状況。タスクがまだ開始されていない場合、このプロパティは0になります。タスクが成功した場合、これは100になります。

タスクが作成された時のタイムスタンプ（ミリ秒単位）。

タスクが開始された時のタイムスタンプ（ミリ秒単位）。

タスクが終了した時のタイムスタンプ（ミリ秒単位）。

タスク結果の有効期限のタイムスタンプ（ミリ秒単位）。

先行タスクの数。ステータスがPENDINGのときのみ意味があります。

失敗したタスクのエラー詳細。完全なtask_errorオブジェクトの参照についてはエラーを参照してください。

このタスクによって消費されたクレジットの数。FAILEDタスクの場合は0を返します（失敗時にクレジットは返金されます）。

生成されたアーティファクトのダウンロード可能なURL。アーティファクト名でキー付けされています。キーのセットはoutput.formatおよびoptions.light_source_presetに依存します：