Creative Lab — API de luminária

Prompt de texto descrevendo o tema desejado da cúpula da luminária. Obrigatório quando image_url é omitido. Máximo de 800 caracteres.

Foto de origem que a Meshy usa como referência visual para a cúpula da luminária. Obrigatório quando text é omitido. Atualmente oferecemos suporte aos formatos .jpg, .jpeg, .png e .webp.

Há duas maneiras de fornecer a imagem:

• URL publicamente acessível: Uma URL acessível pela internet pública.
• Data URI: Uma Data URI da imagem codificada em base64. Exemplo de uma Data URI: data:image/jpeg;base64,<your base64-encoded image data>.

Dica de categoria do tema para o caminho image-to-3D. Valores disponíveis:

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

Ignorado no caminho text-to-3D.

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

A solicitação era inaceitável. Causas comuns:

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

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

Créditos insuficientes para executar esta tarefa.

Você excedeu seu limite de taxa.

O ID da tarefa de uma tarefa de protótipo criada por meio deste mesmo endpoint OpenAPI. O protótipo deve ter sido criado com a mesma chave de API, deve ter alcançado SUCCEEDED e deve ter produzido exatamente uma imagem candidata.

Tarefas de protótipo criadas pelo webapp não são aceitas — o endpoint de build 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 exibição. Máximo de 100 caracteres.

Dimensão máxima alvo da caixa delimitadora da cúpula de luminária, em milímetros. A malha é escalada uniformemente para caber. Intervalo: [50, 400].

Espessura de parede da cúpula de luminária oca, em milímetros. Intervalo: (0, 10].

Porcentagem da altura da cúpula de luminária a achatar na parte superior para que a impressão possa ficar apoiada na mesa. Intervalo: [1, 100].

Predefinição do suporte da fonte de luz que determina se (e qual) disco de base será gerado junto com a cúpula de luminária. Valores disponíveis:

• bambu_mh001_60mm (padrão) — gera 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 da cúpula de luminária, em milímetros. Significativo apenas quando light_source_preset ≠ none. Intervalo: [-80, 80].

Deslocamento vertical no eixo Z do recorte do suporte em relação à parte inferior da cúpula de luminária, 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 luminária (contendo métricas medidas da malha + o conjunto de opções resolvido) dentro do pacote. Ignorado quando output.format é stl.

Pacote de artefatos retornado pelo build. Valores disponíveis:

• stl (padrão) — retorna a cúpula de luminária como model_urls.lamp_stl, além de model_urls.base_stl quando light_source_preset ≠ none.
• zip — empacota todos os artefatos gerados pelo processador (lamp.stl, base.stl opcional, result.json opcional) em um único zip e o retorna em model_urls.bundle_zip.

A solicitação era inaceitável. Causas comuns:

• Parâmetro ausente: input_task_id é obrigatório.
• UUID inválido: O input_task_id não é um UUID válido.
• Pai não bem-sucedido: A tarefa de protótipo referenciada ainda não alcançou SUCCEEDED.
• Sem candidata: 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 enum.

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

Créditos insuficientes para executar esta tarefa.

A tarefa de protótipo referenciada não existe, pertence a um usuário diferente ou foi criada pelo webapp (somente tarefas de protótipo em mode de API podem ser encadeadas para build).

Você excedeu seu limite de taxa.

Identificador único da tarefa de luminária a ser recuperada.

Identificador único da tarefa de luminária a ser cancelada.

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

A tarefa não existe, pertence a um usuário diferente ou seu estágio não corresponde ao caminho da URL.

Identificador único da tarefa de luminária a ser transmitida.

prototype ou build. A coleção retorna apenas tarefas cuja etapa corresponde à URL — buscar /prototype nunca retorna 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 em ordem crescente.
• -created_at: Ordenar por hora de criação em ordem decrescente.

Identificador exclusivo da tarefa. Embora usemos um UUID k-sortable para ids de tarefas como detalhe de implementação, você não deve fazer nenhuma suposição sobre o formato do id.

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

O nome da tarefa fornecido quando a tarefa foi criada. String vazia se nenhum nome foi fornecido.

Status 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 foi iniciada, esta propriedade será 0. Assim que a tarefa for concluída com sucesso, isso se tornará 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 foi iniciada, esta propriedade será 0.

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

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

A contagem de tarefas anteriores.

Detalhes de 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. Presente quando o status da tarefa é PENDING, IN_PROGRESS ou SUCCEEDED. Retorna 0 para tarefas FAILED (os créditos são reembolsados em caso de falha).

URLs baixáveis para os candidatos de imagem conceitual gerados por esta tarefa de protótipo. Atualmente, a API sempre retorna exatamente um candidato; o campo é um array para que revisões futuras possam apresentar vários candidatos sem uma alteração incompatível.

Identificador exclusivo da tarefa.

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

O nome da tarefa fornecido quando a tarefa foi criada. String vazia se nenhum nome foi fornecido.

Status 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 foi iniciada, esta propriedade será 0. Quando a tarefa for concluída com sucesso, isso se tornará 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 finalizada, em milissegundos.

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

A contagem de tarefas precedentes. Significativo somente quando o status é 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. Retorna 0 para tarefas FAILED (os créditos são reembolsados em caso de falha).

URLs para download dos artefatos gerados, indexadas pelo nome do artefato. O conjunto de chaves depende de output.format e options.light_source_preset: