Saltar al contenido principal

Inicio rápido

La generación 3D es una operación asíncrona; todo el flujo se divide en tres pasos:
Ejemplo mínimo

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
  • prompt e input_references son mutuamente excluyentes (solo puede pasarse uno); únicamente generate_type: "Sketch" permite pasar ambos a la vez (boceto + descripción de texto).
  • En cada elemento de input_references debe pasarse exactamente uno entre image_url e image_base64:
    • image_url solo admite URL públicas http(s), no admite data URL (usa image_base64 en su lugar);
    • image_base64 no debe superar los 6MB una vez decodificado.
  • hy-3d-3.1 no admite el tipo de generación LowPoly.
  • 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

Sondea esta interfaz para comprobar si la tarea ha terminado. Se recomienda consultar cada 10~15 segundos. Las consultas no se facturan.

Ejemplo de respuesta (generación completada)

Descripción de los campos de output[]
content_url y preview_url son enlaces temporales que expiran pasado un tiempo; descárgalos y transfiérelos a tu propio almacenamiento cuanto antes una vez completada la tarea. El ID de la tarea puede consultarse durante las 24 horas posteriores a su creación (el campo expires_at indica el momento límite de consulta); una vez expirado, la consulta devolverá un error. Los enlaces temporales solo admiten solicitudes GET; las solicitudes HEAD devuelven 403.

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_at de la respuesta indica el momento límite de consulta.
  • content_url / preview_url son 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?

Cuando status sea failed, el campo error de la respuesta incluirá la información del error:
Las causas frecuentes de fallo incluyen: contenido que infringe las políticas, formato de imagen no admitido, imagen de referencia inaccesible, etc. Ajústalo según la información del error y vuelve a intentarlo.
Última actualización: 2026-07-17