Creative Lab — API de Luminária

Prompt de texto descrevendo o assunto desejado para o abajur. Obrigatório quando image_url é omitido. Máximo de 800 caracteres.

Foto de origem que a Meshy usa como referência visual para o abajur. Obrigatório quando text é omitido. Atualmente suportamos os formatos .jpg, .jpeg, .png e .webp.

Existem duas maneiras de fornecer a imagem:

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

Dica de categoria de assunto para o caminho imagem-para-3D. Valores disponíveis:

• character (padrão) — assunto de personagem/objeto único (figura, animal, mascote, etc.).
• landscape — assunto de cena ao ar livre/panorama (montanha, paisagem urbana, floresta, etc.).

Ignorado no caminho texto-para-3D.

Nome opcional da tarefa 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 assunto em qualquer fundo.

A solicitação foi 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 é um formato suportado (.jpg, .jpeg, .png, .webp).
• Dimensões da imagem fora do intervalo: A imagem é muito pequena, excede o tamanho máximo do 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 moderação NSFW ou de propriedade intelectual.
• Texto muito longo: text excede 800 caracteres.
• image_subject inválido: Não é um de 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 um protótipo criado através 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 através do aplicativo web não são aceitas — o endpoint de construção aceita apenas tarefas de protótipo produzidas por POST /openapi/creative-lab/lamp/v1/prototype e recusa qualquer outra fonte 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 da luminária, em milímetros. A malha é escalada uniformemente para caber. Intervalo: [50, 400].

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

Percentual da altura da cúpula da luminária a ser achatado no topo para que a impressão possa ficar na base. Intervalo: [1, 100].

Preset de fixação da fonte de luz que determina se (e qual) disco de base emitir junto com a cúpula da luminária. Valores disponíveis:

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

Deslocamento horizontal no eixo X do recorte da fixação em relação ao centro da cúpula da luminária, em milímetros. Apenas significativo quando light_source_preset ≠ none. Intervalo: [-80, 80].

Deslocamento vertical no eixo Z do recorte da fixação em relação à base da cúpula da luminária, em milímetros. Intervalo: [-80, 80].

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

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

Rotação ao redor 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 de malha medidas + o conjunto de opções resolvido) dentro do pacote. Ignorado quando output.format é stl.

Pacote de artefatos retornado pela construção. Valores disponíveis:

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

A solicitaçã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 sucedido: A tarefa de protótipo referenciada ainda não alcançou SUCCEEDED.
• Sem candidato: A tarefa de protótipo teve sucesso, mas não produziu imagem candidata.
• Opções fora do intervalo: Um dos campos options caiu fora do intervalo permitido ou conjunto de enumeração.

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

Créditos insuficientes para realizar esta tarefa.

A tarefa de protótipo referenciada não existe, pertence a um usuário diferente ou foi criada através do aplicativo web (apenas tarefas de protótipo em modo API encadeiam na construção).

Você excedeu seu limite de taxa.

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

Identificador único para a 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 para a tarefa de luminária a ser transmitida.

Ou prototype ou build. A coleção retorna apenas tarefas cujo estágio corresponde à URL — buscar /prototype nunca retorna tarefas de construção e vice-versa.

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

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

Campo para ordenar. Valores disponíveis:

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

Identificador único para a tarefa. Embora usemos um UUID ordenável por k 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 dos PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Progresso da tarefa. Se a tarefa ainda não foi iniciada, esta propriedade será 0. Uma vez que a tarefa tenha sido 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 concluída, em milissegundos. Se a tarefa ainda não foi 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. Veja 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 para download dos candidatos a 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 múltiplos candidatos sem uma mudança disruptiva.

Identificador único para a 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.

Progresso da tarefa. Se a tarefa ainda não foi iniciada, esta propriedade será 0. Uma vez que a tarefa tenha sido 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 concluída, 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 do erro para tarefas falhas. Veja 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 (créditos são reembolsados em caso de falha).

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