Creative Lab — API de candeeiro

Prompt de texto que descreve o tema pretendido para a cúpula do candeeiro. Obrigatório quando image_url é omitido. Máximo de 800 caracteres.

Fotografia de origem que a Meshy utiliza como referência visual para a cúpula do candeeiro. Obrigatória quando text é omitido. Atualmente, suportamos os formatos .jpg, .jpeg, .png e .webp.

Existem duas formas de fornecer a imagem:

• URL publicamente acessível: Um URL acessível a partir da internet pública.
• Data URI: Um Data URI da imagem codificado em base64. Exemplo de um Data URI: data:image/jpeg;base64,<your base64-encoded image data>.

Sugestão da categoria do tema para o percurso image-to-3D. Valores disponíveis:

• character (predefinição) — tema de personagem / objeto único (figurino, animal, mascote, etc.).
• landscape — tema de cena exterior / panorama (montanha, paisagem urbana, floresta, etc.).

Ignorado no percurso text-to-3D.

Nome opcional da tarefa para fins de apresentação. Máximo de 100 caracteres.

O pedido era inaceitável. Causas comuns:

• Parâmetro em falta: É obrigatório exatamente um de text ou image_url.
• Ambos fornecidos: Passar text e image_url é rejeitado — são mutuamente exclusivos.
• Formato de imagem inválido: O image_url fornecido não está num formato suportado (.jpg, .jpeg, .png, .webp).
• Dimensões da imagem fora do intervalo: A imagem é demasiado pequena, excede o tamanho máximo de ficheiro ou excede a contagem máxima de píxeis.
• URL inacessível: Não foi possível descarregar o image_url (404 ou timeout).
• Data URI inválido: A cadeia base64 está malformada.
• Conteúdo sinalizado: A imagem de entrada foi sinalizada por moderation de NSFW ou propriedade intelectual.
• Texto demasiado longo: text excede 800 caracteres.
• image_subject inválido: Não é um de character / landscape.

A autenticação falhou. Verifique a sua chave de API.

Créditos insuficientes para executar esta tarefa.

Excedeu o seu limite de taxa.

O ID da tarefa de uma tarefa de protótipo criada através deste mesmo endpoint OpenAPI. O protótipo deve ter sido criado com a mesma chave de API, deve ter atingido SUCCEEDED e deve ter produzido exatamente uma imagem candidata.

As tarefas de protótipo criadas através da aplicação Web não são aceites — o endpoint de construção aceita apenas tarefas de protótipo produzidas por POST /openapi/creative-lab/lamp/v1/prototype e recusa qualquer outra origem com 404.

Nome opcional da tarefa para fins de apresentação. Máximo de 100 caracteres.

Dimensão máxima alvo da caixa delimitadora do abajur, em milímetros. A malha é escalada uniformemente para caber. Intervalo: [50, 400].

Espessura de parede do abajur oco, em milímetros. Intervalo: (0, 10].

Percentagem da altura do abajur a aplanar no topo para que a impressão possa assentar na mesa. Intervalo: [1, 100].

Predefinição do suporte da fonte de luz que determina se (e qual) disco de base deve ser emitido juntamente com o abajur. Valores disponíveis:

• bambu_mh001_60mm (predefinição) — emite um disco de base de 60 mm dimensionado para um suporte de fonte de luz compatível. O resultado inclui model_urls.base_stl.
• none — sem suporte, sem disco de base. model_urls.base_stl é omitido.

Deslocamento horizontal no eixo X do recorte do suporte em relação ao centro do abajur, em milímetros. Só é significativo quando light_source_preset ≠ none. Intervalo: [-80, 80].

Deslocamento vertical no eixo Z do recorte do suporte em relação à parte inferior do abajur, em milímetros. Intervalo: [-80, 80].

Rotação em torno do eixo X aplicada à malha importada antes do processamento, em graus. Intervalo: [-360, 360].

Rotação em torno do eixo Y aplicada à malha importada antes do processamento, em graus. Intervalo: [-360, 360].

Rotação em torno do eixo Z aplicada à malha importada antes do processamento, em graus. Intervalo: [-360, 360].

Quando true e output.format é zip, inclui o result.json do processador de candeeiro (contendo métricas medidas da malha + o conjunto de opções resolvido) dentro do pacote. Ignorado quando output.format é stl.

Pacote de artefactos devolvido pela construção. Valores disponíveis:

• stl (predefinição) — devolve o abajur como model_urls.lamp_stl, além de model_urls.base_stl quando light_source_preset ≠ none.
• zip — empacota todos os artefactos emitidos pelo processador (lamp.stl, base.stl opcional, result.json opcional) num único zip e devolve-o em model_urls.bundle_zip.

O pedido não era aceitável. Causas comuns:

• Parâmetro em falta: input_task_id é obrigatório.
• UUID inválido: O input_task_id não é um UUID válido.
• Tarefa principal não bem-sucedida: A tarefa de protótipo referenciada ainda não atingiu SUCCEEDED.
• Sem candidato: A tarefa de protótipo foi bem-sucedida, mas não produziu nenhuma imagem candidata.
• Opções fora do intervalo: Um dos campos de options ficou fora do intervalo permitido ou do conjunto de enumeração.

A autenticação falhou. Verifique a sua chave de API.

Créditos insuficientes para executar esta tarefa.

A tarefa de protótipo referenciada não existe, pertence a um utilizador diferente ou foi criada através da aplicação Web (apenas tarefas de protótipo em mode de API podem ser encadeadas para construção).

Excedeu o seu limite de taxa.

Identificador único da tarefa de candeeiro a obter.

Identificador único da tarefa de candeeiro a cancelar.

A tarefa já está num estado terminal e não pode ser cancelada.

A tarefa não existe, pertence a um utilizador diferente ou a sua fase não corresponde ao caminho do URL.

Identificador único da tarefa de candeeiro a transmitir em fluxo.

Ou prototype ou build. A coleção devolve apenas tarefas cuja fase corresponde ao URL — obter /prototype nunca devolve tarefas de build e vice-versa.

Número da página para paginação.

Limite de tamanho da página. O máximo permitido é de 50 itens.

Campo pelo qual ordenar. Valores disponíveis:

• +created_at: Ordenar por hora de criação por ordem ascendente.
• -created_at: Ordenar por hora de criação por ordem descendente.

Identificador único da tarefa. Embora utilizemos um UUID k-sortable para os ids das tarefas como detalhe de implementação, não deve fazer quaisquer suposições sobre o formato do id.

Tipo da tarefa. O valor é creative-lab-lamp-prototype.

O nome da tarefa fornecido quando a tarefa foi criada. Cadeia vazia se não tiver sido fornecido qualquer nome.

Estado da tarefa. Os valores possíveis são um de PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

progress da tarefa. Se a tarefa ainda não tiver sido iniciada, esta propriedade será 0. Assim que a tarefa tiver sido concluída com êxito, passará a 100.

Carimbo de data/hora de quando a tarefa foi criada, em milissegundos.

Carimbo de data/hora de quando a tarefa foi iniciada, em milissegundos. Se a tarefa ainda não tiver sido iniciada, esta propriedade será 0.

Carimbo de data/hora de quando a tarefa foi concluída, em milissegundos. Se a tarefa ainda não tiver sido concluída, esta propriedade será 0.

Carimbo de data/hora de quando o resultado da tarefa expira, em milissegundos.

A contagem de tarefas precedentes.

Detalhes do erro para tarefas falhadas. Consulte Erros para a referência completa do objeto task_error.

O número de créditos consumidos por esta tarefa. Presente quando o estado da tarefa é PENDING, IN_PROGRESS ou SUCCEEDED. Devolve 0 para tarefas FAILED (os créditos são reembolsados em caso de falha).

URLs transferíveis para as imagens de conceito candidatas geradas por esta tarefa de protótipo. Atualmente, a API devolve sempre exatamente uma candidata; o campo é uma matriz para que revisões futuras possam disponibilizar múltiplas candidatas sem uma alteração disruptiva.

Identificador único da tarefa.

Tipo da tarefa. O valor é creative-lab-lamp-build.

O nome da tarefa fornecido quando a tarefa foi criada. Cadeia vazia se não tiver sido fornecido nenhum nome.

Estado da tarefa. Os valores possíveis são um de PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

O progress da tarefa. Se a tarefa ainda não tiver sido iniciada, esta propriedade será 0. Assim que a tarefa tiver sido concluída com êxito, passará a 100.

Carimbo de data/hora de quando a tarefa foi criada, em milissegundos.

Carimbo de data/hora de quando a tarefa foi iniciada, em milissegundos.

Carimbo de data/hora de quando a tarefa foi terminada, em milissegundos.

Carimbo de data/hora de quando o resultado da tarefa expira, em milissegundos.

A contagem de tarefas precedentes. Significativo apenas quando o estado é PENDING.

Detalhes do erro para tarefas com falha. Consulte Erros para a referência completa do objeto task_error.

O número de créditos consumidos por esta tarefa. Devolve 0 para tarefas FAILED (os créditos são reembolsados em caso de falha).

URLs transferíveis para os artefactos gerados, indexados pelo nome do artefacto. O conjunto de chaves depende de output.format e options.light_source_preset: