Creative Lab — API de íman de frigorífico

Fotografia de origem para a Meshy colorir numa imagem de conceito pronta para íman de frigorífico. 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>.

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: image_url é obrigatório.
• 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 é 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á mal formada.
• Conteúdo sinalizado: A imagem de entrada foi sinalizada por moderation NSFW ou de propriedade intelectual.

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 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 exatamente uma imagem candidata.

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

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

Silhueta do contorno do íman de frigorífico. Valores disponíveis:

• circle
• rounded-rect (predefinição)
• hexagon
• shield
• star

Comprimento da aresta do quadrado delimitador do íman de frigorífico, em milímetros. Intervalo: (0, 400].

Altura máxima do relevo acima da base, em milímetros. Intervalo: [0, 20].

Deslocamento vertical aplicado ao relevo antes da extrusão, em milímetros. Intervalo: [0, 20].

Espessura da placa de base plana atrás do relevo, em milímetros. A predefinição do íman de frigorífico é uma base mais robusta de 2 mm — dá ao íman corpo suficiente para aderir ao frigorífico sem que o relevo pareça frágil. Intervalo: [0, 20].

Se a parte de trás do íman de frigorífico é selada como uma superfície fechada (o lado onde cola o íman). Defina como false para uma concha aberta.

Curva de transferência que mapeia valores do mapa de profundidade para a altura do relevo. Valores disponíveis:

• linear (predefinição)
• gamma
• s-curve

Parâmetro de forma para a curva de transferência (apenas significativo quando relief_curve é gamma). Intervalo: (0, 10].

Inverte a interpretação do mapa de profundidade para que as regiões mais escuras se tornem relevo mais alto.

Intensidade de suavização aplicada ao mapa de profundidade antes da extração do relevo. Intervalo: [0, 10].

Multiplicador de escala vertical aplicado sobre relief_height_mm. Intervalo: (0, 10].

Limiar passa-baixo para valores do mapa de profundidade; tudo abaixo deste valor é limitado a zero. Intervalo: [0, 1].

Remove automaticamente o fundo da imagem de conceito do protótipo antes de criar o relevo.

Resolução da malha utilizada para exportar. Intervalo: [64, 2048].

Pacote de artefactos devolvido pelo build. Valores disponíveis:

• glb (predefinição) — devolve um único model.glb em model_urls.glb.
• obj — compacta model.obj + model.mtl + texture.png e devolve o pacote em model_urls.obj.
• zip — compacta todos os artefactos emitidos pelo gerador e devolve o pacote 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 concluída com sucesso: A tarefa de protótipo referenciada ainda não atingiu SUCCEEDED.
• Sem candidato: A tarefa de protótipo foi concluída com sucesso, 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 realizar 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 API podem ser encadeadas para build).

Excedeu o seu limite de taxa.

Identificador único da tarefa de íman de frigorífico a obter.

Identificador único da tarefa de íman de frigorífico a cancelar.

A tarefa já se encontra 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 íman de frigorífico a transmitir em fluxo.

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 de tamanho da página. O máximo permitido é 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 pressupostos sobre o formato do id.

Tipo da tarefa. O valor é creative-lab-fridge-magnet-prototype.

O nome da tarefa fornecido quando a tarefa foi criada. String 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 sido iniciada, esta propriedade será 0. Assim que a tarefa tiver sido concluída com sucesso, 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 de 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 descarregáveis para as imagens de conceito candidatas geradas por esta tarefa de protótipo. Atualmente, a API devolve sempre exatamente uma candidata; o campo é um array para que revisões futuras possam apresentar várias candidatas sem uma alteração incompatível.

Identificador único da tarefa.

Tipo da tarefa. O valor é creative-lab-fridge-magnet-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.

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, isto 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 anteriores. Significativo apenas 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 o artefacto gerado, indexados pelo nome do artefacto. Contém sempre exatamente uma entrada — o formato solicitado através do output.format do pedido de criação. A chave corresponde ao formato solicitado: