Creative Lab — API Lampada

Prompt testuale che descrive il soggetto desiderato per il paralume. Richiesto quando image_url è omesso. Massimo 800 caratteri.

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

Ci sono due modi per fornire l'immagine:

• URL pubblicamente accessibile: Un URL accessibile da internet pubblico.
• Data URI: Un Data URI codificato in base64 dell'immagine. Esempio di un Data URI: data:image/jpeg;base64,<your base64-encoded image data>.

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

• character (default) — soggetto singolo personaggio / oggetto (figurina, animale, mascotte, ecc.).
• landscape — soggetto scena esterna / panorama (montagna, skyline, foresta, ecc.).

Ignorato nel percorso text-to-3D.

Nome del task opzionale 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, in modo da poter comporre il soggetto su qualsiasi sfondo.

La richiesta non era accettabile. Cause comuni:

• Parametro mancante: Esattamente uno tra text o image_url è richiesto.
• Entrambi forniti: Passare sia text che image_url è rifiutato — sono mutuamente esclusivi.
• Formato immagine non valido: Il image_url fornito non è 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 dei pixel.
• URL irraggiungibile: Il image_url non può essere scaricato (404 o timeout).
• Data URI non valido: La stringa base64 è malformata.
• Contenuto segnalato: L'immagine di input è stata segnalata dalla moderation NSFW o per proprietà intellettuale.
• Testo troppo lungo: text supera gli 800 caratteri.
• image_subject non valido: Non è uno tra character / landscape.

Autenticazione fallita. Si prega di controllare la tua chiave API.

Crediti insufficienti per eseguire questo task.

Hai superato il tuo limite di frequenza.

L'ID del task di un prototipo creato 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.

I task prototipo creati tramite l'app web non sono accettati — l'endpoint di costruzione accetta solo task prototipo prodotti da POST /openapi/creative-lab/lamp/v1/prototype e rifiuta qualsiasi altra fonte con 404.

Nome del task opzionale per scopi di visualizzazione. Massimo 100 caratteri.

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

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

Percentuale dell'altezza del paralume da appiattire in alto in modo che la stampa possa poggiare sul letto. Intervallo: [1, 100].

Preset di fissaggio della fonte di luce 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 compatibile con la fonte di luce. Il risultato include model_urls.base_stl.
• none — nessun fissaggio, nessun disco di base. model_urls.base_stl è 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 di lampade (contenente metriche della mesh misurate + il set di opzioni risolto) all'interno del pacchetto. Ignorato quando output.format è stl.

Pacchetto di artefatti restituito dalla costruzione. 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, opzionale base.stl, opzionale result.json) in un unico zip e lo restituisce sotto model_urls.bundle_zip.

La richiesta non era accettabile. Cause comuni:

• Parametro mancante: input_task_id è richiesto.
• UUID non valido: L'input_task_id non è un UUID valido.
• Genitore non riuscito: Il task prototipo di riferimento non ha ancora raggiunto SUCCEEDED.
• Nessun candidato: Il task prototipo è riuscito ma non ha prodotto alcuna immagine candidata.
• Opzioni fuori intervallo: Uno dei campi options è caduto fuori dal suo intervallo consentito o set di enum.

Autenticazione fallita. Si prega di controllare la tua chiave API.

Crediti insufficienti per eseguire questo task.

Il task prototipo di riferimento non esiste, appartiene a un altro utente o è stato creato tramite l'app web (solo i task prototipo in modalità API si concatenano nella costruzione).

Hai superato il tuo limite di frequenza.

Identificatore univoco per il compito 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 per il task lampada da trasmettere.

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

Numero di pagina per la paginazione.

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

Campo per l'ordinamento. Valori disponibili:

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

Identificatore univoco per il task. Anche se utilizziamo un UUID ordinabile per k per gli id dei task come dettaglio di implementazione, non dovresti fare alcuna ipotesi sul formato dell'id.

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

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.

Avanzamento 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. Se il task non è ancora iniziato, questa proprietà sarà 0.

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

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

Il conteggio dei task precedenti.

Dettagli degli errori per i task falliti. Vedi 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 i candidati all'immagine concettuale generati da questo task prototipo. Attualmente l'API restituisce sempre esattamente un candidato; il campo è un array in modo che le revisioni future possano presentare più candidati senza una modifica dirompente.

Identificatore univoco per l'attività.

Tipo di attività. Il valore è creative-lab-lamp-build.

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 di PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Avanzamento dell'attività. Se l'attività non è ancora iniziata, questa proprietà sarà 0. Una volta che l'attività è riuscita, diventerà 100.

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

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

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

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

Il conteggio delle attività precedenti. Significativo solo quando lo stato è PENDING.

Dettagli degli errori per le attività fallite. Vedi Errori per il riferimento completo all'oggetto task_error.

Il numero di crediti consumati da questa attività. Restituisce 0 per le attività FAILED (i crediti vengono rimborsati in caso di fallimento).

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