com.rest.meshy

com.rest.meshy

Un cliente generativo no oficial de AI Meshy Restful para el motor Unity Game.

Todos los derechos de autor, marcas comerciales, logotipos y activos son propiedad de sus respectivos propietarios.

Este repositorio está disponible para transferir a la organización Meshy si así eligen aceptarlo.

Instalación

Requiere Unity 2021.3 LTS o superior.

El método de instalación recomendado es a pesar de que Unity Package Manager y OpenUpm.

A través de Unity Package Manager y OpenUpm

• Abra la configuración de su proyecto Unity
• Seleccione el Package Manager
• Agregue el registro del paquete OpenUpm:
  • Nombre: OpenUPM
  • URL: https://package.openupm.com
  • Alcance (s):
    • com.rest.meshy
• Abra la ventana Manager de paquetes de Unity
• Cambiar el registro de la unidad a My Registries
• Agregue el paquete Meshy

A través de Unity Package Manager y Git URL

• Abra su Administrador de paquetes de Unity
• Agregue el paquete de Git URL: https://github.com/RageAgainstThePixel/com.rest.meshy.git#upm

  Nota: ¡Este repositorio tiene dependencias de otros repositorios! Usted es responsable de agregarlos por su cuenta.

  • com.utilidades.async
  • com.utilidades.extensiones
  • com.utilidades.rest

---

Documentación

Tabla de contenido

• Autenticación
• Panel
• Texto a textura
  • Lista de texto a tareas de textura
  • Crear texto a la tarea de textura
• Texto a 3D
  • Lista de texto a tareas 3D
  • Crear texto a la tarea 3D
• Imagen a 3D
  • Lista de la imagen a las tareas 3D
  • Crear imagen a la tarea 3D

Autenticación

Hay 4 formas de proporcionar sus claves API, en orden de precedencia:

️ Recomendamos usar las variables de entorno para cargar la tecla API en lugar de codificarla en su fuente. No se recomienda usar este método en producción, sino solo para aceptar las credenciales de los usuarios, las pruebas locales y los escenarios de inicio rápido.

1. Pase las claves directamente con el constructor ️
2. Objeto scriptable de la unidad ️
3. Cargar la clave del archivo de configuración
4. Utilizar variables de entorno del sistema

Utiliza la MeshyAuthentication cuando inicializa la API como se muestra:

Pase las claves directamente con el constructor

️ Recomendamos usar las variables de entorno para cargar la tecla API en lugar de codificarla en su fuente. No se recomienda usar este método en producción, sino solo para aceptar las credenciales de los usuarios, las pruebas locales y los escenarios de inicio rápido.

 var api = new MeshyClient ( " msy_apikey123 " ) ;

O crear un objeto MeshyAuthentication manualmente

 var api = new MeshyClient ( new MeshyAuthentication ( " msy_apikey123 " ) ) ; 

Objeto scriptable de la unidad

Puede guardar la clave directamente en un objeto scriptable que se encuentra en la carpeta de Assets/Resources .

Puede crear uno nuevo utilizando el menú contextual del panel de proyecto y creando un nuevo objeto Scriptable MeshyConfiguration .

️ Tenga cuidado de verificar este archivo en el control de origen, ya que otras personas podrán ver su clave API.

Cargar la clave del archivo de configuración

Intenta cargar las teclas API desde un archivo de configuración, de forma predeterminada .meshy

Para crear un archivo de configuración, cree un nuevo archivo de texto llamado .meshy y que contenga la línea:

La entrada de la organización es opcional.

Formato json

{
  "apiKey" : " msy_apikey123 "
}

También puede cargar el archivo de configuración directamente con la ruta conocida llamando a métodos estáticos en MeshyAuthentication :

• Carga la configuración .meshy predeterminada en el directorio especificado:

 var api = new MeshyClient ( new MeshyAuthentication ( ) . LoadFromDirectory ( " path/to/your/directory " ) ) ;

• Carga el archivo de configuración desde una ruta específica. El archivo no necesita ser nombrado .meshy siempre que se ajuste al formato JSON:

 var api = new MeshyClient ( new MeshyAuthentication ( ) . LoadFromPath ( " path/to/your/file.json " ) ) ; 

Utilizar variables de entorno del sistema

Utilice las variables de entorno de su sistema especifican una clave y organización API para usar.

• Use MESHY_API_KEY para su clave API.

 var api = new MeshyClient ( new MeshyAuthentication ( ) . LoadFromEnvironment ( ) ) ;

Panel

Puede realizar las mismas tareas en el tablero que lo haría en la aplicación web.

Pro-tip: ¡también puede usar la ventana de contexto para acceder rápidamente a las opciones del editor para prefabricados y objetos de escena!

Acceda al tablero a través de Window/Dashboards/Meshy

• Genere texturas para un modelo 3D existente.
• Genere un modelo 3D a partir de un mensaje de texto.
• Genere un modelo 3D a partir de una imagen.

Texto a textura

Genere rápidamente texturas de alta calidad para sus modelos 3D existentes utilizando indicaciones de texto y arte conceptual.

Lista de texto a tareas de textura

 var api = new MeshyClient ( ) ;
var textToTextureTasks = await api . TextToTextureEndpoint . ListTasksAsync ( 1 , 12 , SortOrder . Descending ) ;

foreach ( var meshyTask in textToTextureTasks )
{
    Debug . Log ( $" { meshyTask . Id } | created_at: { meshyTask . CreatedAt } " ) ;
} 

Crear nuevo texto a la tarea de textura

Crea un nuevo texto para la tarea de textura e informa progresar hasta que se complete la tarea.

Pase en una prefabricación o escena GameObject para ser reutilizados:

 var api = new MeshyClient ( ) ;
var sphere = GameObject . CreatePrimitive ( PrimitiveType . Sphere ) ;
var request = new TextToTextureRequest ( sphere , " Basketball " , " game assets " , enableOriginalUV : false , resolution : Resolutions . X1024 , artStyle : ArtStyles . Realistic ) ;
var taskResult = await MeshyClient . TextToTextureEndpoint . CreateTextToTextureTaskAsync ( request , new Progress < TaskProgress > ( progress => Debug . Log ( $" [ { progress . Id } ] { progress . Status } : { progress . PrecedingTasks ?? progress . Progress } " ) ) ) ;
Assert . IsNotNull ( taskResult ) ;
Debug . Log ( $" { taskResult . Id } | created_at: { taskResult . FinishedAt } | expires_at: { taskResult . ExpiresAt } " ) ;

Si necesita más control sobre el proceso de exportación de GLB, también puede aprobar en su propio objeto GLTFast.Export.GameObjectExport :

 var api = new MeshyClient ( ) ;
var sphere = GameObject . CreatePrimitive ( PrimitiveType . Sphere ) ;
var exportSettings = new ExportSettings
{
    Format = GltfFormat . Binary ,
    FileConflictResolution = FileConflictResolution . Overwrite ,
    ComponentMask = ~ ( ComponentType . Camera | ComponentType . Animation | ComponentType . Light ) ,
} ;
var gameObjectExportSettings = new GameObjectExportSettings
{
    OnlyActiveInHierarchy = false ,
    DisabledComponents = true ,
} ;
var glbExport = new GameObjectExport ( exportSettings , gameObjectExportSettings ) ;
glbExport . AddScene ( new [ ] { sphere } ) ;
var request = new TextToTextureRequest ( glbExport , " Planet " , " game asset, space, vibrant, highly detailed " , enableOriginalUV : false , resolution : Resolutions . X1024 , artStyle : ArtStyles . Realistic ) ;
var taskResult = await MeshyClient . TextToTextureEndpoint . CreateTextToTextureTaskAsync ( request , new Progress < TaskProgress > ( progress => Debug . Log ( $" [ { progress . Id } ] { progress . Status } : { progress . PrecedingTasks ?? progress . Progress } " ) ) ) ;
Assert . IsNotNull ( taskResult ) ;
Debug . Log ( $" { taskResult . Id } | created_at: { taskResult . FinishedAt } | expires_at: { taskResult . ExpiresAt } " ) ;

También puede usar una URL pública:

 var api = new MeshyClient ( ) ;
var modelUrl = " https://github.com/KhronosGroup/UnityGLTF/raw/master/UnityGLTF/Assets/StreamingAssets/Lantern/glTF-Binary/Lantern.glb "
var request = new TextToTextureRequest ( modelUrl , " Lantern " , " game assets " , resolution : Resolutions . X1024 , artStyle : ArtStyles . Realistic ) ;
var taskResult = await api . TextToTextureEndpoint . CreateTextToTextureTaskAsync ( request , new Progress < TaskProgress > ( progress => Debug . Log ( $" [ { progress . Id } ] { progress . Status } : { progress . PrecedingTasks ?? progress . Progress } " ) ) ) ;
Debug . Log ( $" { taskResult . Id } | created_at: { taskResult . FinishedAt } | expires_at: { taskResult . ExpiresAt } " ) ;

Texto a 3D

Genere rápidamente modelos 3D impresionantes utilizando indicaciones de texto.

Lista de texto a tareas 3D

 var api = new MeshyClient ( ) ;
var textTo3DTasks = await MeshyClient . TextTo3DEndpoint . ListTasksAsync ( 1 , 12 , SortOrder . Descending ) ;

foreach ( var meshyTask in textTo3DTasks )
{
    Debug . Log ( $" { meshyTask . Id } | created_at: { meshyTask . CreatedAt } " ) ;
} 

Crear un nuevo texto a la tarea 3D

 var request = new TextTo3DRequest ( " a treasure chest " , " realistic, wooden, carved, highest quality " , resolution : Resolutions . X1024 , artStyle : ArtStyles . Realistic ) ;
var taskResult = await MeshyClient . TextTo3DEndpoint . CreateTextTo3DTaskAsync ( request , new Progress < TaskProgress > ( progress => Debug . Log ( $" [ { progress . Id } ] { progress . Status } : { progress . PrecedingTasks ?? progress . Progress } " ) ) ) ;
Debug . Log ( $" { taskResult . Id } | created_at: { taskResult . FinishedAt } | expires_at: { taskResult . ExpiresAt } " ) ;

Imagen a 3D

Transforme rápidamente sus imágenes 2D en impresionantes modelos 3D y dale vida a tus imágenes.

Lista de la imagen a las tareas 3D

️ Actualmente no funciona con la versión API actual.

 var api = new MeshyClient ( ) ;
var imageTo3dTasks = await api . ImageTo3DEndpoint . ListTasksAsync ( 1 , 12 , SortOrder . Descending ) ;

foreach ( var meshyTask in imageTo3dTasks )
{
    Debug . Log ( $" { meshyTask . Id } | created_at: { meshyTask . CreatedAt } " ) ;
} 

Crear una nueva imagen para la tarea 3D

 var api = new MeshyClient ( ) ;
var imageUrl = " https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Assets/main/Models/Fox/screenshot/screenshot-x150.jpg " ;
var request = new ImageTo3DRequest ( imageUrl ) ;
var taskResult = await api . ImageTo3DEndpoint . CreateImageTo3DTaskAsync ( request , new Progress < TaskProgress > ( progress => Debug . Log ( $" [ { progress . Id } ] { progress . Status } : { progress . PrecedingTasks ?? progress . Progress } " ) ) ) ;
Assert . IsNotNull ( taskResult ) ;
Debug . Log ( $" { taskResult . Id } | created_at: { taskResult . FinishedAt } | expires_at: { taskResult . ExpiresAt } " ) ;