Creative Lab — API de Figuras Vinil

Foto-fonte para a Meshy estilizar como uma figura de vinil de cabeça grande. Atualmente suportamos os formatos .jpg, .jpeg, .png, e .webp.

Existem duas maneiras de fornecer a imagem:

• URL publicamente acessível: Um URL que é 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,<os teus dados de imagem codificados em base64>.

Nome opcional da tarefa para fins de exibiçã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 dos limites: A imagem é demasiado 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 descarregado (404 ou timeout).
• Data URI inválido: A string base64 está malformada.
• Conteúdo sinalizado: A imagem de entrada foi sinalizada pela moderação NSFW ou de propriedade intelectual.

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 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 protótipos criadas através da webapp não são aceitas — o endpoint de construção aceita apenas tarefas protótipos produzidas por POST /openapi/creative-lab/vinyl-figure/v1/prototype e recusa qualquer outra fonte com 404.

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

A requisiçã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.
• Prototipo não sucedido: A tarefa protótipo referenciada ainda não alcançou SUCCEEDED.
• Sem candidato: A tarefa protótipo sucedeu mas não produziu imagem candidata.

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

Créditos insuficientes para realizar esta tarefa.

A tarefa protótipo referenciada não existe, pertence a um utilizador diferente ou foi criada através da webapp (apenas tarefas protótipos em modo API se encadeiam em construção).

Excedeu o seu limite de taxa.

Identificador único para a tarefa de figura de vinil a recuperar.

Identificador único para a tarefa de vinil figura a cancelar.

A tarefa já está em um 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 para a tarefa de figura de vinil a transmitir.

Ou prototype ou build. A coleção retorna apenas tarefas cuja fase corresponde à URL — buscar /prototype nunca retorna 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 é 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. Enquanto utilizamos um UUID k-sortable para ids de tarefas como detalhe de implementação, não deves fazer quaisquer suposições sobre o formato do id.

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

O nome da tarefa fornecido quando a tarefa foi criada. String vazia se nenhum nome foi fornecido.

Estado 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. Depois que a tarefa tiver sido concluída com sucesso, isto 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 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.

O número de tarefas anteriores.

Detalhes do erro para tarefas falhadas. Veja Erros para 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 descarregáveis para os candidatos a imagens conceito gerados por esta tarefa protótipo. Atualmente, a API retorna sempre exatamente um candidato; o campo é uma matriz, pelo que futuras revisões podem apresentar múltiplos candidatos sem uma alteração de quebra.

Identificador único para a tarefa.

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

O nome da tarefa fornecido quando a tarefa foi criada. String vazia se nenhum nome foi fornecido.

Estado da tarefa. 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. Uma vez que a tarefa for 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 estado é PENDING.

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. Retorna 0 para tarefas FAILED (créditos são reembolsados em caso de falha).

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

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

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

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

URLs descarregáveis para o modelo 3D gerado. A construção de figura de vinil emite um GLB texturizado mais o par OBJ + MTL para pipelines que preferem Wavefront OBJ. O formato do campo corresponde ao objeto Imagem para 3D model_urls para que futuras adições de formato entrem sem uma alteração disruptiva.

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

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