Creative Lab — API de figura

Fotografia de origem para a Meshy estilizar como uma figura chibi. Atualmente suportamos os formatos .jpg, .jpeg, .png e .webp.

Existem duas formas de fornecer a imagem:

• URL acessível publicamente: Um URL acessível a partir da internet pública.
• Data URI: Um Data URI codificado em base64 da imagem. 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 não foi aceitá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 transferir o image_url (404 ou timeout).
• Data URI inválido: A string base64 está malformada.
• Conteúdo sinalizado: A imagem de entrada foi sinalizada por moderation de NSFW ou 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.

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

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

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.
• Elemento pai sem sucesso: A tarefa de protótipo referenciada ainda não atingiu SUCCEEDED.
• Sem candidato: A tarefa de protótipo foi bem-sucedida, mas não produziu nenhuma imagem candidata.

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

Créditos insuficientes para executar 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 podem ser encadeadas para build).

Excedeu o seu limite de taxa.

Identificador único da tarefa de figura a obter.

Identificador único da tarefa de figura a cancelar.

A tarefa já está 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 figura a transmitir em fluxo.

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

Identificador único da tarefa. Embora utilizemos um UUID k-ordenável para IDs de tarefa como detalhe de implementação, não deve fazer quaisquer pressupostos sobre o formato do id.

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

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

O carimbo de data/hora de quando a tarefa foi criada, em milissegundos.

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

O carimbo de data/hora de quando a tarefa foi concluída, em milissegundos. Se a tarefa ainda não estiver concluída, esta propriedade será 0.

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

O número de tarefas precedentes.

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. 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 candidatas de imagem de conceito geradas por esta tarefa de protótipo. Atualmente, a API devolve sempre exatamente uma candidata; o campo é uma matriz para que revisões futuras possam disponibilizar várias candidatas sem uma alteração incompatível.

Identificador único da tarefa.

Tipo da tarefa. O valor é creative-lab-figure-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 bem-sucedida, 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 concluída, em milissegundos.

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

A contagem de tarefas precedentes. Só é significativo 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).

Sempre vazio para a construção de figura. Presente para compatibilidade entre endpoints com a forma partilhada V2ImageTo3DTaskResponse utilizada por Imagem para 3D.

Sempre vazio para a construção de figura. Presente para compatibilidade entre endpoints.

Sempre vazio para a construção de figura. Presente para compatibilidade entre endpoints.

Sempre vazio para a construção de figura. Presente para compatibilidade entre endpoints.

URLs descarregáveis para o modelo 3D gerado. A construção de figura emite um GLB com textura, mais o par OBJ + MTL para pipelines que preferem Wavefront OBJ. A forma do campo corresponde ao objeto Imagem para 3D model_urls, para que futuras adições de formatos possam ser integradas sem uma alteração disruptiva.

URL descarregável para a imagem de miniatura do ficheiro do modelo.

Uma matriz de objetos de URL de textura gerados por esta tarefa. Atualmente contém um único objeto com o mapa de cor base.