API de imagen a 3D. Dentro de tu app.

Vista previa de ángulos

0,00 US$

Sin consumo de créditos, dentro del límite de vistas previas de tu cuenta. Revísala antes de iniciar la generación de pago.

Por generación 3D completa · pago por uso

0,64 US$

64 créditos por la hoja final de vistas y el GLB con textura. Incluye el flujo completo de foto a 3D.

Acceso por API y MCP

Incluido

Usa tu cuenta y tus créditos desde cualquiera de las dos integraciones. Sin tarifa adicional por el conector.

Consulta renderCredits en la respuesta antes de generar: indica el coste en créditos de ese render. Implementa la aprobación y los límites de gasto en tu aplicación. Las generaciones 3D fallidas devuelven sus créditos. Los precios corresponden a tu moneda y oferta actuales.

1. 01

   Sube la foto y previsualiza

   Envía un archivo JPEG, PNG o WebP como formulario multipart. Guarda el ID del render y consulta su progreso.

2. 02

   Aprueba la generación

   Muestra la vista previa y el coste en créditos en tu interfaz. Llama al endpoint de generación cuando decidas gastar los créditos.

3. 03

   Obtén el GLB

   Consulta el estado desde tu servidor, gestiona los fallos y descarga el modelo terminado con tu clave API.

1. 01 · Sube tu foto

   Usa tu propio archivo product.jpg. La respuesta incluye id, status y renderCredits. El campo image es un archivo, no un campo image_url en JSON.

   POST /api/rendersCopiar

   curl --fail-with-body "$EASYRENDER_URL/api/renders" \
     --header "Authorization: Bearer $EASYRENDER_API_KEY" \
     --form "image=@product.jpg"

2. 02 · Elige la visibilidad

   Sustituye EASYRENDER_RENDER_ID por el id de la respuesta. Los renders terminados son públicos por defecto. Esta petición evita que el render aparezca en la galería pública; envíala antes de iniciar la generación.

   PATCH /api/renders/{id}Copiar

   export EASYRENDER_RENDER_ID="REPLACE_WITH_RESPONSE_ID"
   
   curl --fail-with-body --request PATCH \
     "$EASYRENDER_URL/api/renders/$EASYRENDER_RENDER_ID" \
     --header "Authorization: Bearer $EASYRENDER_API_KEY" \
     --header "Content-Type: application/json" \
     --data '{"isPublic":false}'

3. 03 · Espera a la vista previa

   Repite la primera petición dejando un intervalo hasta que status sea preview_ready. Después ejecuta la segunda e inspecciona preview.webp. Usa renderCredits del JSON para mostrar el coste. Detén el flujo si status es failed.

   GET estado → GET vista previaCopiar

   curl --fail-with-body \
     "$EASYRENDER_URL/api/renders/$EASYRENDER_RENDER_ID" \
     --header "Authorization: Bearer $EASYRENDER_API_KEY"
   
   curl --fail-with-body \
     "$EASYRENDER_URL/api/renders/$EASYRENDER_RENDER_ID/preview" \
     --header "Authorization: Bearer $EASYRENDER_API_KEY" \
     --output preview.webp

4. 04 · Inicia la generación de pago

   Esta petición gasta créditos. Ejecútala tras revisar la vista previa, confirmar el coste y comprobar que hay saldo suficiente. Tu aplicación debe implementar su propio paso de aprobación.

   POST /api/renders/{id}/renderCopiar

   export EASYRENDER_MAX_CREDITS="REPLACE_WITH_APPROVED_CREDIT_CEILING"
   
   curl --fail-with-body --request POST \
     "$EASYRENDER_URL/api/renders/$EASYRENDER_RENDER_ID/render" \
     --header "Authorization: Bearer $EASYRENDER_API_KEY" \
     --header "Content-Type: application/json" \
     --data '{"maxCredits":'"$EASYRENDER_MAX_CREDITS"'}'

5. 05 · Descarga cuando esté listo

   Repite la consulta de estado dejando un intervalo hasta que status sea ready y hasModel sea true. Solo entonces ejecuta la descarga. El estado failed termina el proceso; los modelos fallidos devuelven sus créditos.

   GET estado → GET modeloCopiar

   curl --fail-with-body \
     "$EASYRENDER_URL/api/renders/$EASYRENDER_RENDER_ID" \
     --header "Authorization: Bearer $EASYRENDER_API_KEY"
   
   curl --fail-with-body \
     "$EASYRENDER_URL/api/renders/$EASYRENDER_RENDER_ID/model?download=1" \
     --header "Authorization: Bearer $EASYRENDER_API_KEY" \
     --output product.glb

En tu aplicación, consulta el estado con un intervalo y un tiempo máximo de espera. Los ejemplos muestran peticiones individuales, no un bucle automático de reintentos. Ante errores HTTP, consulta los campos error y code del JSON.