Inicio rápido
La generación 3D es una operación asíncrona; todo el flujo se divide en tres pasos:Resumen de las interfaces
Base URL:
https://aihubmix.com
Método de autenticación: Bearer Token
A diferencia de la interfaz de vídeo, la interfaz 3D no dispone del endpoint de descarga
/content ni del endpoint de eliminación DELETE: los archivos generados se descargan directamente mediante el content_url incluido en output[] de la respuesta de consulta.Modelos compatibles
Tipos de generación (
generate_type)
Descripción detallada de la API
Cabeceras de la petición
Crear tarea de generación 3D
Cuerpo de la petición
Reglas de validación de parámetros
prompteinput_referencesson mutuamente excluyentes (solo puede pasarse uno); únicamentegenerate_type: "Sketch"permite pasar ambos a la vez (boceto + descripción de texto).- En cada elemento de
input_referencesdebe pasarse exactamente uno entreimage_urleimage_base64:image_urlsolo admite URL públicashttp(s), no admite data URL (usaimage_base64en su lugar);image_base64no debe superar los 6MB una vez decodificado.
hy-3d-3.1no admite el tipo de generaciónLowPoly.- El tamaño total del cuerpo de la petición no debe superar los 10MB.
Uso de
extra_body: los parámetros nativos del upstream (como polygon_type) pueden colocarse en el nivel superior de extra_body para su reenvío transparente. Los siguientes parámetros deben pasarse como campos de nivel superior; si aparecen en extra_body se devolverá un 400: model, prompt, image_url, image_base64, generate_type, enable_pbr, face_count, result_format; multi_view_images (imágenes de múltiples vistas) no se admite por ahora.Ejemplo de respuesta
Descripción de los valores de estado
Consultar el estado de la tarea
Ejemplo de respuesta (generación completada)
output[]
Ejemplos de uso
Ejemplo completo de invocación
Facturación
- Facturación por invocación: el precio lo determina la combinación de
modelo × generate_type × si se activa PBR × si se especifica el número de caras × si se especifica el formato; consulta los precios concretos en la galería de modelos. - El cobro se produce cuando la tarea se crea correctamente; consultar el estado de la tarea y descargar los archivos generados no se factura.
- Las combinaciones de parámetros sin precio configurado devuelven directamente un 400 al crear la tarea, sin generar ningún cargo.
FAQ
¿Cuánto tarda la generación 3D?
Suele tardar varios minutos; el tiempo concreto depende del modelo, el tipo de generación y la configuración del número de caras. Se recomienda sondear la interfaz de consulta con un intervalo de 10~15 segundos.¿Cuál es la validez de los enlaces de los archivos generados y de la tarea?
- El ID de la tarea puede consultarse durante las 24 horas posteriores a su creación; el campo
expires_atde la respuesta indica el momento límite de consulta. content_url/preview_urlson enlaces temporales del upstream que expiran pasado un tiempo; descárgalos y transfiérelos cuanto antes una vez completada la tarea.
¿Se pueden pasar prompt y la imagen de referencia a la vez?
No; ambos son mutuamente excluyentes. La única excepción es generate_type: "Sketch" (boceto a 3D), que permite pasar a la vez la imagen del boceto y la descripción de texto.
¿Qué diferencias hay entre los tipos de generate_type?
¿Cómo gestionar una tarea fallida?
Cuandostatus sea failed, el campo error de la respuesta incluirá la información del error:
Última actualización: 2026-07-17