クイックスタート
3D 生成は非同期処理であり、全体のフローは3つのステップに分かれます:インターフェース概要
Base URL:
https://aihubmix.com
認証方式:Bearer Token
動画インターフェースとは異なり、3D インターフェースには
/content ダウンロードエンドポイントおよび DELETE 削除エンドポイントはありません。成果物は照会レスポンスの output[] に含まれる content_url から直接ダウンロードします。サポートされているモデル
生成タイプ(
generate_type)
API 詳細説明
リクエストヘッダー
3D 生成タスクの作成
リクエストボディ
パラメータ検証ルール
promptとinput_referencesは排他です(どちらか一方のみ指定可能)。generate_type: "Sketch"の場合のみ、両方の同時指定(スケッチ + テキスト記述)が許可されます。input_referencesの各項目ではimage_urlとimage_base64のうちちょうど 1 つを指定する必要があります:image_urlはhttp(s)の公開 URL のみサポートし、data URL はサポートしません(image_base64を使用してください);image_base64はデコード後 6MB 以内である必要があります。
hy-3d-3.1はLowPoly生成タイプをサポートしません。- リクエストボディの合計サイズは 10MB 以内である必要があります。
extra_body の使用について:上流のネイティブパラメータ(polygon_type など)は extra_body のトップレベルに入れてパススルーできます。以下のパラメータは必ずトップレベルフィールドとして指定してください。extra_body 内に含めると 400 が返されます:model、prompt、image_url、image_base64、generate_type、enable_pbr、face_count、result_format;multi_view_images(マルチビュー画像)は現在サポートされていません。レスポンス例
ステータス値の説明
タスクステータスの照会
レスポンス例(生成完了)
output[] フィールドの説明
使用サンプル
完全な呼び出しサンプル
課金の説明
- 回数ごとの課金:価格は
モデル × generate_type × PBR の有無 × 面数指定の有無 × 形式指定の有無の組み合わせで決まります。具体的な価格はモデル広場を参照してください。 - 課金はタスク作成成功時に発生します。タスクステータスの照会と成果物のダウンロードは課金対象外です。
- 価格が設定されていないパラメータの組み合わせは、作成時に直接 400 を返し、課金は発生しません。
FAQ
3D 生成にはどのくらい時間がかかりますか?
通常は数分かかり、具体的な時間はモデル、生成タイプ、面数の設定によって異なります。10~15 秒の間隔で照会インターフェースをポーリングすることを推奨します。成果物リンクとタスクの有効期限はどのくらいですか?
- タスク ID は作成から 24 時間以内照会可能で、レスポンスの
expires_atフィールドが照会期限の時刻です。 content_url/preview_urlは上流の一時リンクであり、一定時間後に有効期限が切れます。タスク完了後は速やかにダウンロードして転送保存してください。
prompt と参考画像を同時に指定できますか?
できません。両者は排他です。唯一の例外は generate_type: "Sketch"(スケッチから 3D)で、スケッチ画像とテキスト記述の同時指定が許可されます。
generate_type の各タイプにはどんな違いがありますか?
タスクが失敗した場合の対処は?
status が failed の場合、レスポンスの error フィールドにエラー情報が含まれます:
最終更新:2026-07-17