Creative Lab — API lampada

Prompt di testo che descrive il soggetto desiderato del paralume. Richiesto quando image_url viene omesso. Massimo 800 caratteri.

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

Esistono 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,<your base64-encoded image data>.

Suggerimento sulla categoria del soggetto per il percorso image-to-3D. Valori disponibili:

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

Ignorato nel percorso text-to-3D.

Nome attività opzionale a scopo di visualizzazione. Massimo 100 caratteri.

La richiesta non era accettabile. Cause comuni:

• Parametro mancante: è richiesto esattamente uno tra text o image_url.
• Entrambi forniti: passare sia text sia image_url viene rifiutato — sono mutuamente esclusivi.
• Formato immagine non valido: l'image_url fornito non è in un formato supportato (.jpg, .jpeg, .png, .webp).
• Dimensioni immagine fuori intervallo: l'immagine è troppo piccola, supera la dimensione massima del file o supera il conteggio massimo di pixel.
• URL non raggiungibile: non è stato possibile scaricare l'image_url (404 o timeout).
• Data URI non valido: la stringa base64 è malformata.
• Contenuto segnalato: l'immagine di input è stata segnalata dalla moderation NSFW o della proprietà intellettuale.
• Testo troppo lungo: text supera 800 caratteri.
• image_subject non valido: non è uno tra character / landscape.

Autenticazione non riuscita. Controlla la tua chiave API.

Crediti insufficienti per eseguire questa attività.

Hai superato il tuo limite di frequenza.

L'ID attività di un'attività 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 esattamente un'immagine candidata.

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

Nome attività opzionale a scopo di visualizzazione. Massimo 100 caratteri.

Dimensione massima target della 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 paralume da appiattire nella parte superiore affinché la stampa possa poggiare sul piano. Intervallo: [1, 100].

Preset di fissaggio della sorgente luminosa che determina se (e quale) disco di base emettere insieme al paralume. Valori disponibili:

• bambu_mh001_60mm (predefinito) — emette un disco di base da 60 mm dimensionato per un fissaggio sorgente luminosa compatibile. Il risultato include model_urls.base_stl.
• none — nessun fissaggio, nessun disco di base. model_urls.base_stl viene omesso.

Offset orizzontale sull'asse X del ritaglio del fissaggio rispetto al centro del paralume, in millimetri. Significativo solo quando light_source_preset ≠ none. Intervallo: [-80, 80].

Offset verticale sull'asse Z del ritaglio del fissaggio rispetto al fondo del paralume, in millimetri. Intervallo: [-80, 80].

Rotazione attorno all'asse X applicata alla mesh importata prima dell'elaborazione, in gradi. 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 processore lampada (contenente metriche della mesh misurate + il set di opzioni risolto) all'interno del bundle. Ignorato quando output.format è stl.

Bundle di artefatti restituito dalla build. Valori disponibili:

• stl (predefinito) — restituisce il paralume come model_urls.lamp_stl, 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 singolo 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.
• Elemento padre non riuscito: l'attività prototipo referenziata non ha ancora raggiunto SUCCEEDED.
• Nessun candidato: l'attività prototipo è riuscita ma non ha prodotto alcuna immagine candidata.
• Opzioni fuori intervallo: uno dei campi options è uscito dal relativo intervallo consentito o set di enum.

Autenticazione non riuscita. Controlla la tua chiave API.

Crediti insufficienti per eseguire questa attività.

L'attività prototipo referenziata non esiste, appartiene a un utente diverso o è stata creata tramite la webapp (solo le attività prototipo in modalità API possono essere concatenate alla build).

Hai superato il tuo limite di frequenza.

Identificatore univoco dell'attività lampada da recuperare.

Identificatore univoco dell'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 oppure la sua fase non corrisponde al percorso dell'URL.

Identificatore univoco dell'attività lampada di cui eseguire lo streaming.

O prototype o build. La raccolta restituisce solo le attività la cui fase corrisponde all'URL — recuperare /prototype non restituisce mai attività build e viceversa.

Numero di pagina per la paginazione.

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

Campo in base al quale ordinare. Valori disponibili:

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

Identificatore univoco dell'attività. Sebbene utilizziamo un UUID k-sortable per gli id delle attività come dettaglio implementativo, non dovresti fare alcuna supposizione sul formato dell'id.

Tipo dell'attività. Il valore è creative-lab-lamp-prototype.

Il nome dell'attività fornito quando l'attività è stata creata. Stringa vuota se non è stato fornito alcun nome.

Stato dell'attività. I valori possibili sono uno tra PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

progress dell'attività. Se l'attività non è ancora stata avviata, questa proprietà sarà 0. Una volta che l'attività ha avuto esito positivo, diventerà 100.

Timestamp di quando l'attività è stata creata, in millisecondi.

Timestamp di quando l'attività è stata avviata, in millisecondi. Se l'attività non è ancora stata avviata, questa proprietà sarà 0.

Timestamp di quando l'attività è stata completata, in millisecondi. Se l'attività non è ancora completata, questa proprietà sarà 0.

Timestamp di quando il risultato dell'attività scade, in millisecondi.

Il numero di attività precedenti.

Dettagli dell'errore per le attività non riuscite. Consulta Errori per il riferimento completo dell'oggetto task_error.

Il numero di crediti consumati da questa attività. Presente quando lo stato dell'attività è PENDING, IN_PROGRESS o SUCCEEDED. Restituisce 0 per le attività FAILED (i crediti vengono rimborsati in caso di errore).

URL scaricabili per le immagini concettuali candidate generate da questa attività 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 per il task.

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

Il nome del task fornito quando il task è stato creato. Stringa vuota se non è stato fornito alcun nome.

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

progress 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 stato è PENDING.

Dettagli dell'errore per i task non riusciti. Vedi Errori per il riferimento completo dell'oggetto task_error.

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

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