メインコンテンツへスキップ

クイックスタート

3D 生成は非同期処理であり、全体のフローは3つのステップに分かれます:
最小サンプル

インターフェース概要

Base URL:https://aihubmix.com 認証方式:Bearer Token
動画インターフェースとは異なり、3D インターフェースには /content ダウンロードエンドポイントおよび DELETE 削除エンドポイントはありません。成果物は照会レスポンスの output[] に含まれる content_url から直接ダウンロードします。

サポートされているモデル

生成タイプ(generate_type

API 詳細説明

リクエストヘッダー

3D 生成タスクの作成

リクエストボディ

パラメータ検証ルール
  • promptinput_references排他です(どちらか一方のみ指定可能)。generate_type: "Sketch" の場合のみ、両方の同時指定(スケッチ + テキスト記述)が許可されます。
  • input_references の各項目では image_urlimage_base64 のうちちょうど 1 つを指定する必要があります:
    • image_urlhttp(s) の公開 URL のみサポートし、data URL はサポートしませんimage_base64 を使用してください);
    • image_base64 はデコード後 6MB 以内である必要があります。
  • hy-3d-3.1LowPoly 生成タイプをサポートしません。
  • リクエストボディの合計サイズは 10MB 以内である必要があります。
extra_body の使用について:上流のネイティブパラメータ(polygon_type など)は extra_body のトップレベルに入れてパススルーできます。以下のパラメータは必ずトップレベルフィールドとして指定してください。extra_body 内に含めると 400 が返されます:modelpromptimage_urlimage_base64generate_typeenable_pbrface_countresult_formatmulti_view_images(マルチビュー画像)は現在サポートされていません。

レスポンス例

ステータス値の説明

タスクステータスの照会

このインターフェースをポーリングしてタスクが完了したか確認します。10~15 秒 ごとに照会することを推奨します。照会は課金対象外です。

レスポンス例(生成完了)

output[] フィールドの説明
content_urlpreview_url一時リンクであり、一定時間後に有効期限が切れます。タスク完了後は速やかにダウンロードし、ご自身のストレージへ転送保存してください。タスク ID は作成から 24 時間以内照会可能です(expires_at フィールドが照会期限の時刻です)。期限切れ後の照会はエラーを返します。一時リンクは GET リクエストのみをサポートし、HEAD リクエストは 403 を返します。

使用サンプル

完全な呼び出しサンプル

課金の説明

  • 回数ごとの課金:価格は モデル × generate_type × PBR の有無 × 面数指定の有無 × 形式指定の有無 の組み合わせで決まります。具体的な価格はモデル広場を参照してください。
  • 課金はタスク作成成功時に発生します。タスクステータスの照会と成果物のダウンロードは課金対象外です。
  • 価格が設定されていないパラメータの組み合わせは、作成時に直接 400 を返し、課金は発生しません。

FAQ

3D 生成にはどのくらい時間がかかりますか?

通常は数分かかり、具体的な時間はモデル、生成タイプ、面数の設定によって異なります。10~15 秒の間隔で照会インターフェースをポーリングすることを推奨します。

成果物リンクとタスクの有効期限はどのくらいですか?

  • タスク ID は作成から 24 時間以内照会可能で、レスポンスの expires_at フィールドが照会期限の時刻です。
  • content_url / preview_url は上流の一時リンクであり、一定時間後に有効期限が切れます。タスク完了後は速やかにダウンロードして転送保存してください。

prompt と参考画像を同時に指定できますか?

できません。両者は排他です。唯一の例外は generate_type: "Sketch"(スケッチから 3D)で、スケッチ画像とテキスト記述の同時指定が許可されます。

generate_type の各タイプにはどんな違いがありますか?

タスクが失敗した場合の対処は?

statusfailed の場合、レスポンスの error フィールドにエラー情報が含まれます:
よくある失敗原因には、コンテンツ違反、画像形式が非対応、参考画像へアクセスできないなどがあります。エラー情報に基づいて調整してから再試行してください。
最終更新:2026-07-17