Creative Lab — API de Figura de Vinil

Fotografia de origem para a Meshy estilizar como uma vinyl figure de cabeça grande. 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 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 o número máximo de píxeis.
• URL inacessível: Não foi possível transferir 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 conteúdo NSFW ou de propriedade intelectual.

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

Créditos insuficientes para realizar esta tarefa.

Excedeu o seu limite de taxa.

O ID da tarefa de um protótipo criado através deste mesmo endpoint da OpenAPI. O protótipo tem de ter sido criado com a mesma chave de API, tem de ter atingido SUCCEEDED e tem de ter produzido exatamente uma imagem candidata.

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/vinyl-figure/v1/prototype e recusa qualquer outra origem com 404.

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

O pedido era 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: 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 qualquer imagem candidata.

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 outro utilizador, ou foi criada através da webapp (apenas tarefas de protótipo em modo API encadeiam para a construção).

Excedeu o seu limite de taxa.

Identificador único da tarefa de figura de vinil a obter.

Identificador único da tarefa de figura de vinil 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 figura de vinil a transmitir.

prototype ou build. A coleção devolve apenas as 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 é 100 itens.

Campo pelo qual ordenar. Valores disponíveis:

• +created_at: Ordenar pela hora de criação em ordem ascendente.
• -created_at: Ordenar pela hora de criação em 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 suposições sobre o formato do id.

Tipo da tarefa. O valor é creative-lab-vinyl-figure-prototype.

O nome da tarefa fornecido no momento da criação da tarefa. 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.

Progresso da tarefa. Se a tarefa ainda não tiver começado, esta propriedade será 0. Assim que a tarefa for concluída com sucesso, 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. Devolve 0 para tarefas FAILED (os créditos são reembolsados em caso de falha).

URLs transferíveis para os candidatos a imagem de conceito gerados por esta tarefa de protótipo. Atualmente, a API devolve sempre exatamente um candidato; o campo é uma matriz para que futuras revisões possam apresentar múltiplos candidatos sem uma alteração incompatível.

Identificador único da tarefa.

Tipo da tarefa. O valor é creative-lab-vinyl-figure-build.

O nome da tarefa fornecido no momento da criação. 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 for bem-sucedida, passará a 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 em que o resultado da tarefa expira, em milissegundos.

A contagem de tarefas precedentes. Só tem significado 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 o vinyl figure build. Presente para compatibilidade entre endpoints com a estrutura partilhada V2ImageTo3DTaskResponse utilizada por Imagem para 3D.

Sempre vazio para o vinyl figure build. Presente para compatibilidade entre endpoints.

Sempre vazio para o vinyl figure build. Presente para compatibilidade entre endpoints.

Sempre vazio para o vinyl figure build. Presente para compatibilidade entre endpoints.

URLs para descarregar o modelo 3D gerado. O vinyl figure build produz um GLB texturizado, além do par OBJ + MTL para pipelines que preferem o formato Wavefront OBJ. A forma deste campo corresponde ao objeto model_urls do Imagem para 3D, de modo que futuras adições de formato se integrem sem alterações disruptivas.

URL para descarregar a imagem de miniatura do ficheiro do modelo.

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