Enterprise API

Enterprise API è una funzionalità che ti consente di integrare le capacità Enterprise di Meshy nella tua applicazione. Queste funzionalità API sono disponibili solo per gli utenti con il nostro piano di livello enterprise. In questa sezione troverai tutte le informazioni necessarie per iniziare a utilizzare questa API.

GET/openapi/v1/showcases

List Showcases

Questo endpoint ti consente di cercare e restituire modelli showcase della community disponibili per il download. Puoi restituire un massimo di 10 modelli in una singola richiesta e ogni richiesta costerà 1 credit.

Parametri

Attributi opzionali

Name
page_size
Type
integer
Description
Il numero di modelli showcase da restituire. Deve essere un numero positivo compreso tra 1 e 10 inclusi. Nota che è possibile che la richiesta restituisca un numero di modelli corrispondenti inferiore a quello richiesto se non vengono trovate corrispondenze sufficienti. Non verrà restituito alcun modello se non viene trovata alcuna corrispondenza. Il valore predefinito è 3 modelli se page_size non viene fornito.
Name
sort_by
Type
string
Description
Metodo per ordinare i risultati di ricerca ottenuti. Se non specificato, i risultati verranno ordinati per tempo di creazione, dal più recente al meno recente (-created_at).
- +created_at: Ordina per tempo di creazione in ordine crescente.
- -created_at: Ordina per tempo di creazione in ordine decrescente.
- +updated_at: Ordina per tempo di aggiornamento in ordine crescente.
- -updated_at: Ordina per tempo di aggiornamento in ordine decrescente.
- +downloads: Ordina per numero di download in ordine crescente.
- -downloads: Ordina per numero di download in ordine decrescente.
Name
search
Type
string
Description
Testo da cercare tra i nomi dei modelli pubblicati dalla community (CC0). Se non fornito, verranno restituiti i migliori modelli della community in generale (in base a sort_by).
Name
format
Type
string
Description
Formato del modello 3D desiderato per i risultati restituiti. Tutti i modelli recuperati saranno nel formato specificato. Deve essere uno dei valori opzionali indicati di seguito. Se non fornito, sarà glb per impostazione predefinita.
- glb: formato glb.
- fbx: formato fbx.
- obj: formato obj.
- usdz: formato usdz.
Name
showcase_type
Type
string
Description
Tipo di modello desiderato per i risultati restituiti. Tutti i modelli recuperati saranno del tipo specificato. Deve essere uno dei valori opzionali indicati di seguito. Se non fornito, sarà all per impostazione predefinita.
- all: Tutti i modelli showcase.
- animated: Modelli showcase animati.
- static: Modelli showcase statici.

Restituisce

Name
id
Type
string
Description
L'identificatore univoco del modello showcase. Sebbene utilizziamo un UUID k-sortable come dettaglio implementativo per l'id del task, non dovresti presupporre alcun formato specifico per l'id.
Name
result_id
Type
string
Description
L'identificatore univoco del risultato del modello restituito. Questo ID è collegato al modello e può essere utilizzato direttamente in altri task API come remesh.
Name
model_url
Type
object
Description
L'URL del modello 3D scaricabile con le texture. Per impostazione predefinita restituisce il formato glb.
Name
conversion_status
Type
string
Description
Lo stato di conversione del tipo di file dei modelli restituiti.
- <stringa vuota>: Non convertito (glb predefinito).
- success: Conversione riuscita.
- failed: Conversione non riuscita.
Name
community_url
Type
string
Description
Il link di navigazione della community del modello showcase.
Name
author
Type
string
Description
L'autore del modello showcase.
Name
topology
Type
string
Description
La topology del modello showcase (quad o triangle).
Name
name
Type
string
Description
Il nome del modello showcase.
Name
object_prompt
Type
string
Description
La descrizione del modello showcase.
Name
categories
Type
array
Description
Le categorie del modello showcase.
Name
tags
Type
array
Description
I tag del modello showcase.
Name
mode
Type
string
Description
Il mode del modello showcase.
Name
created_at
Type
timestamp
Description
Il timestamp di creazione del modello showcase (millisecondi).
Name
updated_at
Type
timestamp
Description
Il timestamp di aggiornamento del modello showcase (millisecondi).

Request

GET

/openapi/v1/showcases

curl "https://api.meshy.ai/openapi/v1/showcases?page_size=10&sort_by=-created_at&search=car&format=glb" \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "result": [
    {
      "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
      "result_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
      "model_url": "https://api.meshy.ai/v1/models/018a210d-8ba4-705c-b111-1f1776f7f578/model.glb",
      "conversion_status": "success",
      "community_url": "https://www.meshy.ai/showcase/018a210d-8ba4-705c-b111-1f1776f7f578",
      "author": "John Doe",
      "topology": "quad",
      "name": "Car",
      "object_prompt": "A car",
      "categories": ["vehicle"],
      "tags": ["car", "vehicle"],
      "mode": "3d",
      "created_at": 1717171717171,
      "updated_at": 1717171717171
    }
  ]
}