Creative Lab — API lampada

Foto sorgente che Meshy usa come riferimento visivo per il paralume. Attualmente supportiamo i formati .jpg, .jpeg, .png e .webp.

Ci sono due modi per fornire l'immagine:

• URL accessibile pubblicamente: un URL accessibile da internet pubblico.
• Data URI: un data URI dell'immagine codificato in base64. Esempio di Data URI: data:image/jpeg;base64,<i tuoi dati immagine codificati in base64>.

Suggerimento della categoria del soggetto che seleziona il prompt di stylization. Valori disponibili:

• character (predefinito) — soggetto singolo personaggio/oggetto (personaggio, animale, mascotte, ecc.).
• landscape — soggetto scena esterna/panorama (montagna, paesaggio urbano, foresta, ecc.).

Nome opzionale dell'attività per scopi di visualizzazione. Massimo 100 caratteri.

Quando impostato su true, l'immagine del prototipo viene restituita come PNG RGBA trasparente con lo sfondo rimosso, così puoi comporre il soggetto su qualsiasi sfondo.

La richiesta non era accettabile. Cause comuni:

• Parametro mancante: image_url è obbligatorio.
• Formato immagine non valido: l'image_url fornito non è un formato supportato (.jpg, .jpeg, .png, .webp).
• Dimensioni dell'immagine fuori intervallo: l'immagine è troppo piccola, supera la dimensione massima del file o supera il conteggio massimo di pixel.
• URL non raggiungibile: l'image_url non ha potuto essere scaricato (404 o timeout).
• Data URI non valido: la stringa base64 è malformata.
• Contenuto segnalato: l'immagine di input è stata segnalata dalla moderation per contenuti NSFW o proprietà intellettuale.
• image_subject non valido: non è uno tra character / landscape.

Autenticazione fallita. Controlla la tua chiave API.

Crediti insufficienti per eseguire questa attività.

Hai superato il tuo limite di frequenza.

L'ID dell'attività di un'attività di prototipo creata tramite questo stesso endpoint OpenAPI. Il prototipo deve essere stato creato con la stessa chiave API, deve aver raggiunto SUCCEEDED e deve aver prodotto un modello 3D.

Le attività di prototipo create tramite la webapp non sono accettate — l'endpoint di build accetta solo attività di prototipo prodotte da POST /openapi/creative-lab/lamp/v1/prototype e rifiuta qualsiasi altra origine con 404.

Nome facoltativo dell'attività per scopi di visualizzazione. Massimo 100 caratteri.

Dimensione massima target del bounding box del paralume, in millimetri. La mesh viene scalata uniformemente per adattarsi. Intervallo: [50, 400].

Spessore parete del paralume cavo, in millimetri. Intervallo: (0, 10].

Percentuale dell'altezza del modello tagliata piatta sul fondo, in modo che il paralume poggi sul piano di stampa e abbia un'apertura per la fixture. Intervallo: [1, 100].

Preset della fixture per la sorgente luminosa che determina come viene costruito il fondo. Valori disponibili:

• bambu_mh001_60mm (predefinito) — paralume con fondo aperto più una base che porta un foro fixture da 60 mm, entrambi in model_urls.lamp_stl, e il supporto della fixture come model_urls.base_stl.
• none — un singolo paralume sigillato in model_urls.lamp_stl; model_urls.base_stl viene omesso.

Offset sull'asse X del foro fixture sulla base, relativo al centro del paralume, in millimetri. Ha significato solo quando light_source_preset ≠ none. Intervallo: [-80, 80].

Offset sull'asse Z (profondità) del foro fixture sulla base, relativo al centro del paralume, in millimetri. Ha significato solo quando light_source_preset ≠ none. Intervallo: [-80, 80].

Rotazione attorno all'asse X applicata al modello prima dell'elaborazione, in gradi. Le tre rotazioni vengono applicate come angoli di Eulero XYZ attorno al centro del modello. Intervallo: [-360, 360].

Rotazione attorno all'asse Y applicata alla mesh importata prima dell'elaborazione, in gradi. Intervallo: [-360, 360].

Rotazione attorno all'asse Z applicata alla mesh importata prima dell'elaborazione, in gradi. Intervallo: [-360, 360].

Quando true e output.format è zip, include il result.json del lamp processor (nome della pipeline, avvisi e percorsi degli artefatti) all'interno del pacchetto. Ignorato quando output.format è stl.

Pacchetto di artefatti restituito dal build. Valori disponibili:

• stl (predefinito) — restituisce model_urls.lamp_stl (il paralume, insieme alla base quando è impostato un preset di fixture), più model_urls.base_stl quando light_source_preset ≠ none.
• zip — impacchetta ogni artefatto emesso dal processore (lamp.stl, base.stl opzionale, result.json opzionale) in un unico zip e lo restituisce sotto model_urls.bundle_zip.

La richiesta non era accettabile. Cause comuni:

• Parametro mancante: input_task_id è obbligatorio.
• UUID non valido: input_task_id non è un UUID valido.
• Genitore non riuscito: l'attività di prototipo referenziata non ha ancora raggiunto SUCCEEDED.
• Nessun modello: l'attività di prototipo è riuscita ma non ha prodotto alcun modello 3D.
• Opzioni fuori intervallo: uno dei campi di options è fuori dall'intervallo consentito o dal set di valori enumerati.

Autenticazione non riuscita. Verifica la tua chiave API.

Crediti insufficienti per eseguire questa attività.

L'attività di prototipo referenziata non esiste, appartiene a un altro utente, oppure è stata creata tramite la webapp (solo le attività di prototipo in modalità API si concatenano al build).

Hai superato il limite di frequenza.

Identificatore univoco del task lampada da recuperare.

Identificatore univoco per l'attività lampada da annullare.

L'attività è già in uno stato terminale e non può essere annullata.

L'attività non esiste, appartiene a un altro utente o la sua fase non corrisponde al percorso URL.

Identificatore univoco del task lampada da trasmettere in streaming.

prototype oppure build. La raccolta restituisce solo le attività il cui stage corrisponde all'URL — richiedere /prototype non restituisce mai attività di build e viceversa.

Numero di pagina per la paginazione.

Limite di dimensione della pagina. Il massimo consentito è 50 elementi.

Campo in base al quale ordinare. Valori disponibili:

• +created_at: Ordina per data di creazione in ordine crescente.
• -created_at: Ordina per data di creazione in ordine decrescente.

Identificatore univoco del task. Sebbene utilizziamo un UUID k-sortable per gli id dei task come dettaglio implementativo, non dovresti fare alcuna assunzione sul formato dell'id.

Tipo del task. Il valore è creative-lab-lamp-prototype.

Il nome del task fornito al momento della creazione. Stringa vuota se non è stato fornito alcun nome.

Stato del task. I valori possibili sono uno tra PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Progresso del task. Se il task non è ancora iniziato, questa proprietà sarà 0. Una volta che il task ha avuto successo, diventerà 100.

Timestamp di quando il task è stato creato, in millisecondi.

Timestamp di quando il task è stato avviato, in millisecondi. Se il task non è ancora stato avviato, questa proprietà sarà 0.

Timestamp di quando il task è stato terminato, in millisecondi. Se il task non è ancora terminato, questa proprietà sarà 0.

Timestamp di quando il risultato del task scade, in millisecondi.

Il conteggio dei task precedenti.

Dettagli dell'errore per i task falliti. Consulta Errori per il riferimento completo all'oggetto task_error.

Il numero di crediti consumati da questo task. Presente quando lo stato del task è PENDING, IN_PROGRESS, o SUCCEEDED. Restituisce 0 per i task FAILED (i crediti vengono rimborsati in caso di fallimento).

URL scaricabili per il modello 3D generato dall'immagine concettuale. Presente una volta che il task ha avuto successo; {} prima di ciò.

URL scaricabile per un'anteprima renderizzata del modello 3D. Stringa vuota finché il task non ha avuto successo.

URL scaricabili per i candidati dell'immagine concettuale generati da questo task di prototipo. Attualmente l'API restituisce sempre esattamente un candidato; il campo è un array in modo che revisioni future possano mostrare più candidati senza una modifica incompatibile.

Identificatore univoco del task.

Tipo del task. Il valore è creative-lab-lamp-build.

Il nome del task fornito al momento della creazione del task. Stringa vuota se non è stato fornito alcun nome.

Stato del task. I valori possibili sono uno tra PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Progresso del task. Se il task non è ancora iniziato, questa proprietà sarà 0. Una volta che il task è riuscito, diventerà 100.

Timestamp di quando il task è stato creato, in millisecondi.

Timestamp di quando il task è stato avviato, in millisecondi.

Timestamp di quando il task è stato completato, in millisecondi.

Timestamp di quando il risultato del task scade, in millisecondi.

Il numero di task precedenti. Significativo solo quando lo status è PENDING.

Dettagli dell'errore per i task falliti. Vedi Errori per il riferimento completo all'oggetto task_error.

Il numero di crediti consumati da questo task. Restituisce 0 per i task FAILED (i crediti vengono rimborsati in caso di fallimento).

URL scaricabili per gli artefatti generati, indicizzati per nome dell'artefatto. L'insieme di chiavi dipende da output.format e options.light_source_preset: