Plataforma para desarrolladores
La Plataforma para desarrolladores es donde ejecutas, monitoreas y configuras todo lo relacionado con tu integración con la Meshy API: un Playground para probar endpoints sin escribir código, paneles que cubren cada solicitud de API en tu cuenta, y la gestión de claves de API y webhooks.
Las cuentas Free solo pueden probar el Playground en el endpoint de Imagen a 3D, a través de una clave integrada dedicada para pruebas; las cuentas Free no pueden crear ni gestionar sus propias claves de API, y no tienen Panel de uso ni Registros de solicitudes. Los planes Pro, Premium, Ultra, Studio y Enterprise obtienen todos los endpoints del Playground, acceso completo al Panel de uso y a los Registros de solicitudes, y sus propias claves de API.
Resumen
Abre la Plataforma para desarrolladores desde la aplicación web. Su barra lateral está organizada en:
- Build (Construir) — el Playground, para probar endpoints de forma interactiva.
- Monitor (Monitorear) — Panel de uso y Registros de solicitudes.
- Configure (Configurar) — Claves de API y Webhooks.
La página de Resumen guía a las cuentas nuevas a través de los tres pasos que se muestran a continuación (crear una clave, probar una solicitud en el Playground, inspeccionar el resultado en Registros de solicitudes), y luego muestra una instantánea de uso de 7 días de la actividad de tu propia cuenta y las entradas más recientes del registro de cambios de la Meshy API.
¿Eres nuevo en la API? Comienza con el Inicio rápido.
Playground
El Playground es una consola interactiva para probar endpoints sin escribir código. Elige un endpoint, completa los parámetros con orientación en línea, y envía — las tareas se ejecutan a través de la misma canalización asíncrona que la API, así que verás cómo la tarea pasa de PENDING a SUCCEEDED y podrás inspeccionar la respuesta completa y el modelo resultante.
Mientras una tarea se ejecuta, la pestaña Preview transmite actualizaciones de estado en vivo, sin necesidad de hacer polling.
Cambia a la pestaña Request para obtener un fragmento listo para ejecutar en cURL, Python o JavaScript, o a la pestaña Response para inspeccionar el JSON completo — aquí es donde el Playground demuestra su valor frente al espacio de trabajo de la aplicación web: cada solicitud que construyes está a solo un copiar y pegar de ejecutarse en tu propio código.
Panel de uso
El Panel de uso visualiza toda la actividad de API de tu cuenta — cada solicitud, ya sea realizada directamente a través de la API o desde el Playground. Muestra la tasa de éxito de generación, el total de solicitudes, el tiempo de procesamiento promedio y los créditos consumidos, además del volumen de solicitudes a lo largo del tiempo y un desglose de la tasa de éxito y la latencia por endpoint.
Registros de solicitudes
Registros de solicitudes enumera todas las tareas de API de tu cuenta — tanto las llamadas directas a la API como las solicitudes del Playground — con el estado, el tiempo y la clave de API que realizó la solicitud. Selecciona una tarea para ver su entrada y salida completas, el cuerpo de la solicitud y los créditos utilizados — útil para depurar una llamada específica sin volver a consultar la API — o salta directamente a ella en el Playground. Usa Export CSV para extraer la lista completa para informes o conciliación.
Gestión de API
- API Keys — crea, nombra y revoca claves, establece un límite mensual de créditos para cada una, y consulta el uso de cada clave.
- Webhooks — obtén actualizaciones en tiempo real cuando el estado de tus tareas de API cambie, en lugar de hacer polling. Consulta la guía de Webhooks para conocer los pasos de configuración, los requisitos de entrega y ejemplos de payloads.
Comentarios
Cada página de la Plataforma para desarrolladores tiene un botón Feedback en la esquina inferior derecha — úsalo para reportar un error, solicitar una función o contarnos qué te resulta confuso. Leemos cada envío.
Autenticación y créditos
Las solicitudes se autorizan con una clave de API pasada en el encabezado Authorization: Bearer, exactamente igual que una llamada directa a la API. El Playground se ejecuta contra tu propia cuenta, así que cada solicitud utiliza los créditos de tu plan y cuenta para tus límites de tasa, igual que cualquier otra llamada a la API. Consulta la guía de Autenticación para más detalles sobre los formatos de clave y la seguridad.