Creative Lab — API de luminária

Foto de origem que a Meshy usa como referência visual para o abajur. Atualmente suportamos os formatos .jpg, .jpeg, .png e .webp.

Há duas formas de fornecer a imagem:

• URL publicamente acessível: Uma URL acessível pela internet pública.
• Data URI: Um data URI da imagem codificado em base64. Exemplo de um data URI: data:image/jpeg;base64,<seus dados de imagem codificados em base64>.

Dica de categoria do sujeito que seleciona o prompt de stylization. Valores disponíveis:

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

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

Quando definido como true, a imagem do protótipo é retornada como um PNG RGBA transparente com o fundo removido, para que você possa compor o sujeito sobre qualquer plano de fundo.

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

• Parâmetro ausente: image_url é obrigatório.
• Formato de imagem inválido: O image_url fornecido não está em um formato suportado (.jpg, .jpeg, .png, .webp).
• Dimensões de imagem fora do intervalo: A imagem é muito pequena, excede o tamanho máximo de arquivo, ou excede a contagem máxima de pixels.
• URL inacessível: O image_url não pôde ser baixado (404 ou timeout).
• Data URI inválido: A string base64 está malformada.
• Conteúdo sinalizado: A imagem de entrada foi sinalizada por moderation de conteúdo adulto ou de propriedade intelectual.
• image_subject inválido: Não é um dos valores character / landscape.

A autenticação falhou. Por favor, verifique sua chave de API.

Créditos insuficientes para realizar esta tarefa.

Você excedeu seu limite de taxa.

O ID da tarefa de uma tarefa de prototype criada através deste mesmo endpoint OpenAPI. O prototype deve ter sido criado com a mesma chave de API, deve ter alcançado SUCCEEDED e deve ter produzido um modelo 3D.

Tarefas de prototype criadas através da webapp não são aceitas — o endpoint de build aceita apenas tarefas de prototype produzidas por POST /openapi/creative-lab/lamp/v1/prototype e rejeita qualquer outra origem com 404.

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

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

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

Porcentagem da altura do modelo cortada plana na parte inferior, para que a cúpula da luminária se assente na mesa de impressão e tenha uma abertura para o fixture. Faixa: [1, 100].

Preset de fixture de fonte de luz que determina como a base é construída. Valores disponíveis:

• bambu_mh001_60mm (padrão) — cúpula de luminária com base aberta mais uma placa base com um furo de fixture de 60 mm, ambos em model_urls.lamp_stl, e o suporte do fixture como model_urls.base_stl.
• none — uma única cúpula de luminária selada em model_urls.lamp_stl; model_urls.base_stl é omitido.

Deslocamento no eixo X do furo do fixture na placa base, em relação ao centro da cúpula da luminária, em milímetros. Só é significativo quando light_source_preset ≠ none. Faixa: [-80, 80].

Deslocamento no eixo Z (profundidade) do furo do fixture na placa base, em relação ao centro da cúpula da luminária, em milímetros. Só é significativo quando light_source_preset ≠ none. Faixa: [-80, 80].

Rotação em torno do eixo X aplicada ao modelo antes do processamento, em graus. As três rotações são aplicadas como ângulos de Euler XYZ em torno do centro do modelo. Faixa: [-360, 360].

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

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

Quando true e output.format é zip, inclui o result.json do processador de luminária (nome do pipeline, avisos e caminhos dos artefatos) dentro do pacote. Ignorado quando output.format é stl.

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

• stl (padrão) — retorna model_urls.lamp_stl (a cúpula da luminária, junto com a placa base quando um preset de fixture é definido), além de model_urls.base_stl quando light_source_preset ≠ none.
• zip — empacota todo artefato que o processador emite (lamp.stl, base.stl opcional, result.json opcional) em um único zip e o retorna sob model_urls.bundle_zip.

A requisição foi 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 concluído com sucesso: A tarefa de prototype referenciada ainda não alcançou SUCCEEDED.
• Nenhum modelo: A tarefa de prototype foi bem-sucedida, mas não produziu nenhum modelo 3D.
• Opções fora da faixa: Um dos campos de options ficou fora de sua faixa permitida ou conjunto de enum.

A autenticação falhou. Por favor, verifique sua chave de API.

Créditos insuficientes para realizar esta tarefa.

A tarefa de prototype referenciada não existe, pertence a um usuário diferente, ou foi criada através da webapp (apenas tarefas de prototype em modo API se encadeiam em 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 cujo estágio corresponde à URL — buscar em /prototype nunca retorna tarefas de build e vice-versa.

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

Limite do tamanho da página. O máximo permitido é 100 itens.

Campo pelo qual ordenar. Valores disponíveis:

• +created_at: Ordena pelo horário de criação em ordem crescente.
• -created_at: Ordena pelo horário de criação em ordem decrescente.

Identificador único para a tarefa. Embora usemos um UUID k-sortable para ids de tarefa como detalhe de implementação, você não deve fazer 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. 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, essa propriedade será 0. Assim que a tarefa for concluída com sucesso, ela 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, essa propriedade será 0.

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

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

A contagem de tarefas precedentes.

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

URLs para download do modelo 3D gerado a partir da imagem de conceito. Presente assim que a tarefa for concluída com sucesso; {} antes disso.

URL para download de uma prévia renderizada do modelo 3D. String vazia até que a tarefa seja concluída com sucesso.

URLs para download dos candidatos a imagem de conceito 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 exibir múltiplos candidatos sem uma alteração incompatível.

Identificador único para a tarefa.

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

O nome da tarefa fornecido quando ela foi criada. String vazia se nenhum nome tiver sido fornecido.

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

Progresso da tarefa. Se a tarefa ainda não tiver começado, essa 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.

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 apenas quando o status é PENDING.

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. 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: