Creative Lab — API de Figura de Vinil

Foto de origem para o Meshy estilizar como uma figura de vinil com 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 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,<your base64-encoded image data>.

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

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 em 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 transferir o image_url (404 ou timeout).
• Data URI inválido: A string base64 está mal formada.
• Conteúdo assinalado: A imagem de entrada foi assinalada por moderation de 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 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 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 opcional da tarefa para fins de apresentaçã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-mãe 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 bem-sucedida mas não produziu nenhuma 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 as tarefas de protótipo em modo API se encadeiam na construção).

Excedeu o seu limite de taxa.

Identificador único da tarefa de vinyl figure a obter.

Identificador único para a tarefa de figura vinyl 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 vinyl a transmitir em stream.

prototype ou build. A coleção devolve apenas as tarefas cuja fase corresponda 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 pelo tempo de criação em ordem ascendente.
• -created_at: Ordenar pelo tempo 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 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 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, este valor 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 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 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 é um array para que futuras revisões possam apresentar vários candidatos sem uma alteração disruptiva.

Identificador único da tarefa.

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

Progresso da tarefa. Se a tarefa ainda não tiver começado, esta propriedade será 0. Depois de a tarefa ser bem-sucedida, tornar-se-á 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ó é significativa quando o estado é PENDING.

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

Sempre vazio para a construção de figuras em vinil. Presente para compatibilidade entre endpoints com a estrutura partilhada V2ImageTo3DTaskResponse utilizada por Imagem para 3D.

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

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

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

URLs para descarregar o modelo 3D gerado. A construção da figura em vinil produz um GLB com textura, além do par OBJ + MTL para pipelines que preferem o Wavefront OBJ. A forma do campo corresponde ao objeto model_urls do Imagem para 3D, para que futuras adições de formato se integrem sem alterações disruptivas.

URL para descarregar 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.