Autenticación

Crea una cuenta de Meshy y una clave de API, luego envía la clave con cada solicitud.

Claves de API

Crea una cuenta de Meshy

Necesitas una cuenta de Meshy para crear y gestionar claves de API. Una solicitud sin una clave de API devuelve 401 Unauthorized.

Para crear una cuenta, regístrate en el sitio web de Meshy.

Crea una clave de API

Después de crear una cuenta, puedes crear claves de API en la página de claves de API de la Plataforma para Desarrolladores.

Puedes crear varias claves de API para diferentes propósitos, por ejemplo una para tu aplicación de iOS y otra para tu aplicación web. Meshy registra el uso de cada clave por separado, y puedes revocar una clave en cualquier momento.

También puedes establecer un límite de créditos mensual en cualquier clave. El límite restringe lo que la clave puede gastar, independientemente del uso general de tu cuenta. Por ejemplo, úsalo para una clave que le des a un contratista o que uses en un entorno específico.

Para crear una clave de API, sigue estos pasos:

1. En la página API Keys, haz clic en Create API Key.
2. En Name, introduce un nombre para la clave.
3. Opcional: En Monthly credit limit (optional), introduce la cantidad máxima de créditos que la clave puede gastar cada mes.
4. Haz clic en Create.
5. Copia la clave y guárdala en un lugar seguro. No podrás volver a ver la clave después de cerrar el cuadro de diálogo.

Usa una clave de API

Envía la clave de API en el encabezado Authorization de cada solicitud, como un token Bearer:

{
  "Authorization": "Bearer msy_sOmEbOgUsApIkEyFoReXaMpLe1234567890"
}

El prefijo Bearer en el valor del encabezado es obligatorio. Para obtener más información sobre los tokens bearer, consulta RFC 6750.

Restringe una clave a direcciones IP

Una lista blanca de IP limita una clave de API a las direcciones desde las que provienen tus solicitudes, como las direcciones de salida públicas de tus servidores. Meshy entonces rechaza la clave desde cualquier otra dirección, por lo que una clave copiada resulta mucho menos útil. Una clave sin lista blanca funciona desde cualquier dirección.

Para las claves de un equipo, solo los administradores del equipo pueden cambiar la lista blanca. Las claves de la CLI no tienen una.

Para configurar una lista blanca, sigue estos pasos:

1. En la página de claves de API, abre el menú de la clave y haz clic en Manage IP allowlist.
2. Agrega cada dirección o rango. Opcional: asigna un nombre a cada una, por ejemplo office NAT.
3. Opcional: haz clic en Check impact para ver cuántas de las solicitudes de la clave en los últimos 7 días habría bloqueado la lista.
4. Guarda la lista.

Cada entrada es una dirección IPv4 o IPv6, como 203.0.113.5, o un bloque CIDR, como 203.0.113.0/24. La lista sigue estas reglas:

• Una clave puede tener hasta 50 entradas, y un nombre puede tener hasta 60 caracteres.
• Una entrada debe ser una dirección pública. Meshy rechaza direcciones privadas, de loopback y de enlace local, como 10.0.0.0/8 o 127.0.0.1, porque ninguna solicitud llega a la API desde ellas. Usa la dirección pública desde la que sale tu tráfico.
• Una entrada no puede permitir todas las direcciones, como 0.0.0.0/0. Para aceptar cualquier dirección, elimina la lista blanca.
• Meshy guarda un bloque CIDR como su dirección de red. Por ejemplo, 203.0.113.5/24 se guarda como 203.0.113.0/24, que es el rango que Meshy aplica.

El cuadro de diálogo también lista las direcciones que usaron la clave en los últimos 7 días, para que puedas agregarlas directamente. Para una clave con mucho tráfico, Meshy muestrea las direcciones, por lo que la lista puede no mostrarlas todas.

Los cambios se aplican en la siguiente solicitud, en un minuto como máximo. Después de eliminar una lista blanca, cualquier dirección puede volver a usar la clave en un minuto.

Una solicitud desde una dirección fuera de la lista blanca devuelve 403 Forbidden con el código de error ip_not_authorized. El mensaje de error nombra la dirección rechazada, para que puedas agregarla si es tuya. Una solicitud rechazada no consume créditos ni cuenta para tus límites de tasa.

Seguridad

Sigue estas pautas para mantener seguros tus datos y solicitudes, junto con las propias prácticas de seguridad de tu equipo.

Seguridad de la capa de transporte

Meshy cifra tus datos en reposo, y la Meshy API usa TLS para cifrar los datos en tránsito. Todas las solicitudes hacia y desde la API pasan por HTTPS, y una solicitud por HTTP recibe 301 Moved Permanently.

Evita HTTP cuando puedas. Si debes enviar una solicitud por HTTP, indica a tu cliente HTTP que siga la redirección a HTTPS. Los siguientes ejemplos muestran cómo hacerlo:

# use `-L` to follow HTTP to HTTPS redirections
curl -L https://api.meshy.ai/openapi/v1/balance \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Las redirecciones solo funcionan para solicitudes GET. Los clientes HTTP reenvían un POST redirigido como un GET sin su cuerpo, así que siempre llama directamente a https:// para crear tareas.

Seguridad de la clave de API

Después de crear una clave de API, la Plataforma para Desarrolladores no vuelve a mostrarla. Guárdala en un lugar seguro, porque cualquiera que tenga la clave puede llamar a la Meshy API en tu nombre. Los miembros del equipo de Meshy tampoco pueden ver ni recuperar una clave revocada por ti.

Si crees que alguien más tiene tu clave, revócala en la página de claves de API. Una clave revocada deja de funcionar.

Una lista blanca de IP hace que una clave filtrada sea mucho menos útil, pero no sustituye la revocación de la clave. Si una clave se filtra, revócala y crea una nueva.

Divulgación de seguridad

Si encuentras un problema de seguridad en la Meshy API, contacta con el soporte de Meshy. Meshy agradece la divulgación responsable y hace todo lo posible por reconocer tu contribución.