Autenticación
Cree una clave de la Direct API en Studio, elija sus permisos y límites de créditos, y envíela con cada solicitud.
Cada solicitud lleva una clave de API de la organización como token de portador (bearer).
Authorization: Bearer mor_live_9f2c…Una clave pertenece a la organización, no a la persona que la creó. Todos los administradores de la organización pueden verla y revocarla, y sigue funcionando cuando su creador deja el equipo. Deja de funcionar cuando se revoca, cuando caduca, cuando se suspende la cuenta de su creador o cuando Morphic desactiva la Direct API para la organización.
Crear una clave
Los permisos de la Direct API solo aparecen una vez que Morphic ha activado la Direct API para su organización. Consulte Obtener acceso.
- En Morphic Studio, abra el menú desplegable de la organización (el logotipo de Morphic, arriba a la izquierda) y seleccione 'Configuración'.
- En la barra lateral izquierda, haga clic en 'Claves de API'. Solo los administradores ven esta pestaña.
- Haga clic en 'Nueva clave'.
- Introduzca un 'Nombre', elija los 'Permisos' que necesita la clave y, si no debe durar para siempre, cuándo 'Caduca'.
- En 'Límites de créditos', establezca el total que la clave podrá gastar en toda su vida y, opcionalmente, un límite diario y uno mensual.
- Marque 'Acepto los Términos de uso de Morphic, incluida la sección de la API para desarrolladores'. Así se aceptan los Términos de uso en nombre de la organización.
- Haga clic en 'Crear clave' y copie el secreto en su gestor de secretos. Solo se muestra una vez.
Cualquiera que tenga el secreto puede gastar los créditos de su organización hasta los límites de la clave. Nunca ponga una clave en un navegador, una aplicación móvil o un repositorio público.
Formato de la clave
mor_live_<64 hex characters>El prefijo le indica a usted, y a los escáneres de secretos, a qué despliegue corresponde la clave.
Permisos
Una clave solo accede a las herramientas que sus permisos (scopes) autorizan. Elija el conjunto más reducido.
| Permiso | Etiqueta en Studio | Concede |
|---|---|---|
projects:read | Leer proyectos y sus archivos | listar proyectos, flujos de trabajo y líneas de tiempo de Compose |
assets:read | Buscar y leer recursos | listar la biblioteca, leer generaciones y su estado, personajes |
assets:write | Subir recursos y editarlos | pasar contenido multimedia por URL, crear líneas de tiempo de Compose |
generations:write | Generar imágenes, video y audio (consume créditos) | todas las herramientas que inician, editan o analizan contenido multimedia |
Una llamada a una herramienta fuera de los permisos de la clave responde 403 insufficient_scope e indica el permiso que falta en data.required_scopes. Los endpoints y las herramientas que no necesitan permiso, como list_voices y /me, están abiertos a todas las claves. El catálogo de herramientas indica el permiso que necesita cada herramienta.
Límites de créditos
Cada clave lleva topes de gasto, establecidos al crearla. Un administrador puede cambiarlos después con 'Editar límites'.
| Límite | Obligatorio | Periodo |
|---|---|---|
total_credit_limit | sí | toda la vida de la clave |
monthly_credit_limit | no | mes natural, UTC |
daily_credit_limit | no | día natural, UTC |
- Una llamada de pago que llevaría la clave por encima de cualquier límite se rechaza con
402 api_key_credit_limit_reachedantes de que empiece nada;data.periodindica qué límite. - El saldo propio de la organización se aplica además: una llamada que no puede pagar se rechaza con
402 insufficient_credits. GET /v1/direct/medevuelve los límites de la clave y su gasto actual. Consulte Créditos y uso.
Rotar una clave
- Cree la nueva clave.
- Despliéguela.
- Revoque la clave antigua con 'Revocar clave'.
Una organización puede tener hasta 10 claves activas, así que la rotación nunca requiere una interrupción.
Si tiene algún problema o alguna pregunta, no dude en ponerse en contacto con nosotros. Estaremos encantados de ayudarle. Escríbanos a support@morphic.com.
Direct API
Genere, edite y gestione imágenes, video y audio en Morphic desde su propio backend a través de HTTPS.
Llamar a una herramienta
Llame a cualquier herramienta de la Direct API con una misma forma de solicitud, lea su resultado y su facturación, y reintente llamadas de pago con seguridad mediante un Idempotency-Key.