Creative Lab — API de Candeeiro

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

Existem duas formas de fornecer a imagem:

• URL publicamente acessível: Um URL que é 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>.

Indicação da categoria do sujeito que seleciona o prompt de stylization. Valores disponíveis:

• character (predefinido) — sujeito único de personagem/objeto (figura, animal, mascote, etc.).
• landscape — sujeito de cena exterior/panorama (montanha, paisagem urbana, floresta, etc.).

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

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

O pedido foi inaceitável. Causas comuns:

• Parâmetro em falta: image_url é obrigatório.
• 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 string em base64 está mal formada.
• Conteúdo assinalado: A imagem de entrada foi assinalada por moderation de NSFW ou de propriedade intelectual.
• image_subject inválido: Não é character / landscape.

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

Créditos insuficientes para realizar esta tarefa.

Excedeu o seu limite de taxa.

O ID de 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 um modelo 3D.

As tarefas de protótipo criadas através da webapp 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 de tarefa opcional para efeitos de exibição. Máximo de 100 carateres.

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

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

Percentagem da altura do modelo cortada de forma plana na base, para que a cúpula do candeeiro assente na base de impressão e tenha uma abertura para a fixação. Intervalo: [1, 100].

Preset de fixação da fonte de luz que determina como a base é construída. Valores disponíveis:

• bambu_mh001_60mm (predefinição) — cúpula de candeeiro com base aberta mais uma placa de base com um orifício de fixação de 60 mm, ambos em model_urls.lamp_stl, e o suporte de fixação como model_urls.base_stl.
• none — uma única cúpula de candeeiro selada em model_urls.lamp_stl; model_urls.base_stl é omitido.

Deslocamento no eixo X do orifício de fixação na placa de base, em relação ao centro da cúpula do candeeiro, em milímetros. Apenas relevante quando light_source_preset ≠ none. Intervalo: [-80, 80].

Deslocamento no eixo Z (profundidade) do orifício de fixação na placa de base, em relação ao centro da cúpula do candeeiro, em milímetros. Apenas relevante quando light_source_preset ≠ none. Intervalo: [-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. 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 candeeiros (nome do pipeline, avisos e caminhos dos artefactos) dentro do pacote. Ignorado quando output.format é stl.

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

• stl (predefinição) — devolve model_urls.lamp_stl (a cúpula do candeeiro, juntamente com a placa de base quando é definido um preset de fixação), mais 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 foi inaceitá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 concluída com sucesso: A tarefa de protótipo referenciada ainda não atingiu SUCCEEDED.
• Sem modelo: A tarefa de protótipo foi bem-sucedida, mas não produziu nenhum modelo 3D.
• Opções fora do intervalo: Um dos campos de options está fora do intervalo permitido ou do conjunto de valores enumerados.

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

Créditos insuficientes para realizar esta tarefa.

A tarefa de protótipo referenciada não existe, pertence a um utilizador diferente ou foi criada através da webapp (apenas tarefas de protótipo em modo API se encadeiam na 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á se encontra num estado terminal e não pode ser cancelada.

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

Identificador único da tarefa de candeeiro a transmitir.

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

Identificador único da tarefa. Embora utilizemos um UUID ordenável por k como detalhe de implementação para os ids das tarefas, 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. 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.

Progress da tarefa. Se a tarefa ainda não tiver começado, esta propriedade será 0. Assim que a tarefa for concluída com sucesso, esta passará a ser 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 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 estado 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 do modelo 3D gerado a partir da imagem de conceito. Presente uma vez que a tarefa tenha sido concluída com sucesso; {} antes disso.

URL para download de uma pré-visualização renderizada do modelo 3D. Cadeia vazia até a tarefa ser concluída com sucesso.

URLs para download dos candidatos a imagem de conceito gerados por esta tarefa de prototipagem. Atualmente, a API devolve sempre exatamente um candidato; o campo é uma matriz para que revisões futuras possam apresentar múltiplos candidatos 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 um nome.

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

Progresso da tarefa. Se a tarefa ainda não tiver sido iniciada, esta propriedade será 0. Assim que a tarefa for bem-sucedida, passará a ser 100.

Carimbo de data/hora da criação da tarefa, em milissegundos.

Carimbo de data/hora do início da tarefa, em milissegundos.

Carimbo de data/hora da conclusão da tarefa, em milissegundos.

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

A contagem de tarefas precedentes. Apenas relevante quando o estado é PENDING.

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