Quick Start
3D generation is an asynchronous operation. The whole process is divided into three steps:API Overview
Base URL:
https://aihubmix.com
Authentication: Bearer Token
Unlike the video API, the 3D API has no
/content download endpoint and no DELETE endpoint: outputs are downloaded directly via the content_url in the output[] array of the query response.Supported Models
Generation Types (
generate_type)
API Details
Request Headers
Create a 3D Generation Task
Request Body
Parameter Validation Rules
promptandinput_referencesare mutually exclusive (only one may be provided); the only exception isgenerate_type: "Sketch", which allows both together (sketch + text description).- Within each
input_referencesitem, exactly one ofimage_urlandimage_base64must be provided:image_urlonly supports publichttp(s)URLs; data URLs are not supported (useimage_base64instead);image_base64must not exceed 6MB after decoding.
hy-3d-3.1does not support theLowPolygeneration type.- The total request body size must not exceed 10MB.
Using
extra_body: Upstream native parameters (such as polygon_type) can be placed at the top level of extra_body for pass-through. The following parameters must be passed as top-level fields — including them in extra_body returns 400: model, prompt, image_url, image_base64, generate_type, enable_pbr, face_count, result_format; multi_view_images (multi-view images) is not supported yet.Example Response
Status Values
Query Task Status
Example Response (Generation Complete)
output[] Field Description
Usage Examples
Complete Invocation Examples
Billing
- Billed per generation: the price is determined by the combination of
model × generate_type × PBR enabled × face count specified × format specified. See the Model Gallery for specific prices. - Billing occurs when the task is created successfully; querying task status and downloading outputs are not billed.
- Parameter combinations without a configured price return 400 directly at creation time and incur no charge.
FAQ
How long does 3D generation take?
It usually takes several minutes, depending on the model, generation type, and face count settings. We recommend polling the query endpoint at a 10-15 second interval.How long are the output links and the task valid?
- The task ID remains queryable for 24 hours after creation; the
expires_atfield in the response indicates the query deadline. content_url/preview_urlare temporary upstream links that expire after a period of time; download and save them promptly after the task completes.
Can I pass both prompt and a reference image?
No — the two are mutually exclusive. The only exception is generate_type: "Sketch" (sketch-to-3D), which allows passing both a sketch image and a text description.
What are the differences between the generate_type options?
How do I handle a failed task?
Whenstatus is failed, the error field in the response contains error information:
Last updated: 2026-07-17