Objetos e criaturas
Liste e leia seus objetos e criaturas, gere imagens e variações, aprove imagens principais e anime clipes de rotação e de repouso num assistente de IA.
As ferramentas de objetos e criaturas permitem que um assistente use os adereços, produtos e criaturas da sua biblioteca: itens e seres com aparência fixa, que continuam iguais em todas as tomadas. O assistente os lista e lê, gera imagens e variações, aprova imagens principais e anima clipes de movimento curtos. Objetos e criaturas funcionam do mesmo jeito; as criaturas acrescentam uma espécie em texto livre. Leia Objetos e adereços e Animais e criaturas para fazer o mesmo trabalho no app.
Objetos e criaturas são criados no app. Nenhuma ferramenta MCP os cria.
Ferramentas de objetos
list_objects
Lista os seus objetos: adereços, acessórios e itens físicos que você reutiliza entre tomadas. Cada linha tem o nome, a descrição, a imagem principal e o número de variações. Dos mais recentes para os mais antigos.
Permissão: assets:read. Créditos: grátis.
| Parâmetro | Tipo | Observações |
|---|---|---|
search | string | Até 5 palavras, com até 200 caracteres. Cada palavra precisa aparecer no nome ou na descrição do objeto, sem diferenciar maiúsculas de minúsculas. Um valor em branco significa nenhuma busca. Use-o quando o usuário citar um objeto pelo nome. |
limit | integer | De 1 a 100. Padrão: 50. |
Retorna: os objetos. Chame get_object para obter as URLs das variações.
get_object
Retorna um objeto completo: cada variação, com o nome e a URL, e as fotos de referência.
Permissão: assets:read. Créditos: grátis.
| Parâmetro | Tipo | Observações |
|---|---|---|
id | string | Obrigatório. O ID do objeto, de list_objects. |
Retorna: o objeto. Um erro quando ele não existe ou não é seu.
generate_object
Gera uma imagem de um objeto (kind: "main") ou uma variação (kind: "asset"). O resultado não é salvo num objeto.
Permissão: workflows:execute. Créditos: o preço do modelo de imagem.
| Parâmetro | Tipo | Observações |
|---|---|---|
name | string | Obrigatório. O nome do objeto. |
kind | string | main (padrão) ou asset. |
description, style | string | A aparência do objeto. |
category | string | furniture, vehicle, weapon, food, clothing, electronics, nature, tool, animal ou other. |
asset_type | string | Para asset: angles, materials, variations ou custom. |
variant | string | Para asset: por exemplo front, wood ou weathered. |
model | string | O modelo de imagem. Padrão: gpt-image-2. |
source_image_url | string | Uma imagem de origem. |
Retorna: um ID de tarefa.
approve_object_main_image
Transforma um candidato concluído na imagem principal do objeto e faz um modelo de visão descrever a forma, o material, o estado e a finalidade dele na descrição canônica.
Permissão: assets:write. Créditos: uma chamada de visão do Claude Sonnet 4.6 para a descrição, cobrada pelos tokens que usou (como as chamadas de LLM são cobradas). A aprovação nunca é recusada por falta de créditos. Quando o seu saldo é baixo demais para a descrição, a imagem é aprovada mesmo assim e a descrição é pulada. Execute recaption_object depois para escrevê-la.
| Parâmetro | Tipo | Observações |
|---|---|---|
object_id | string | Obrigatório. O objeto. |
candidate_job_id | string | Obrigatório. Uma tarefa de imagem concluída feita por você, como um resultado do generate_object. Uma tarefa feita para outro objeto retorna candidate_object_mismatch. |
expected_updated_at | string | O updatedAt do objeto. Quando o objeto mudou desde então, a chamada retorna concurrent_modification com o novo valor. |
Retorna: a URL da imagem principal e a descrição. Quando a descrição falha, a imagem é definida mesmo assim e a descrição fica vazia; execute recaption_object.
recaption_object
Faz o modelo de visão descrever de novo a imagem principal atual, em cerca de 80 a 120 palavras, e salva o texto como descrição canônica.
Permissão: assets:write. Créditos: uma chamada de visão do Claude Sonnet 4.6, cobrada pelos tokens que usou, como a descrição da aprovação.
| Parâmetro | Tipo | Observações |
|---|---|---|
object_id | string | Obrigatório. O objeto. |
Retorna: a nova descrição. main_image_required quando o objeto não tem imagem principal, e caption_failed quando a descrição falha.
generate_object_motion
Anima um objeto num clipe curto, como “rotação lenta de 360 graus”, “objeto flutuando com um leve balanço” ou “panorâmica com paralaxe da esquerda para a direita”.
Permissão: workflows:execute. Créditos: o preço do modelo de vídeo. O padrão, Kling 2.5 Turbo Pro, faz um clipe de 5 segundos por 138 créditos.
| Parâmetro | Tipo | Observações |
|---|---|---|
motion_prompt | string | Obrigatório. O movimento do objeto ou da câmera, com até 2.000 caracteres. |
source_image_url | string | Obrigatório. O primeiro quadro, normalmente a imagem principal aprovada do objeto. |
name | string | Obrigatório. O nome do objeto, usado como contexto no prompt. |
provider | string | kling-turbo (padrão), kling, kling-3.0, minimax, hailuo-2.3, wan-i2v, seedance-2-mini ou bytedance-lite. |
aspect_ratio | string | 1:1 (padrão, para enquadramento de produto), 3:4, 16:9, 9:16 ou 4:3. |
attach_to_object_id | string | Salva o clipe nos clipes de movimento do objeto. A posse do objeto é verificada antes que qualquer crédito seja reservado. |
attach_name | string | O nome do clipe salvo. |
refine_from_video_url | string | Refina um clipe existente com um novo prompt, como vídeo para vídeo, por exemplo “a mesma tomada, mas com rotação mais rápida”. |
canonical_description, category, style | string | Contexto extra para o prompt. |
Retorna: um ID de tarefa. O cartão reproduz o clipe quando ele fica pronto.
Ferramentas de criaturas
list_creatures
Lista as suas criaturas: animais e seres não humanos com aparência fixa. Cada linha tem o nome, a descrição, a imagem principal e o número de variações. Das mais recentes para as mais antigas.
Permissão: assets:read. Créditos: grátis.
| Parâmetro | Tipo | Observações |
|---|---|---|
search | string | Até 5 palavras, com até 200 caracteres. Cada palavra precisa aparecer no nome ou na descrição da criatura, sem diferenciar maiúsculas de minúsculas. Um valor em branco significa nenhuma busca. |
limit | integer | De 1 a 100. Padrão: 50. |
Retorna: as criaturas. Chame get_creature para obter as URLs das variações.
get_creature
Retorna uma criatura completa: cada variação, com o nome e a URL, as fotos de referência e a voz salva dela.
Permissão: assets:read. Créditos: grátis.
| Parâmetro | Tipo | Observações |
|---|---|---|
id | string | Obrigatório. O ID da criatura, de list_creatures. |
Retorna: a criatura. Um erro quando ela não existe ou não é sua.
generate_creature
Gera uma imagem de uma criatura (kind: "main") ou uma variação (kind: "asset"). O resultado não é salvo numa criatura.
Permissão: workflows:execute. Créditos: o preço do modelo de imagem.
| Parâmetro | Tipo | Observações |
|---|---|---|
name | string | Obrigatório. O nome da criatura. |
kind | string | main (padrão) ou asset. |
species | string | Texto livre, como dragon, wolf ou griffin, com até 200 caracteres. |
category | string | Texto livre, como mammal, mythical ou reptile. |
style | string | Texto livre, como realistic, anime, 3d-pixar ou illustration. |
description | string | A aparência da criatura. |
asset_type | string | Para asset: angles, poses, variations ou custom. |
variant | string | Para asset: por exemplo front, standing ou weathered. |
model | string | O modelo de imagem. Padrão: gpt-image-2. |
source_image_url | string | Uma imagem de origem. |
Retorna: um ID de tarefa.
approve_creature_main_image
Transforma um candidato concluído na imagem principal da criatura e faz um modelo de visão descrever a espécie, a anatomia, a coloração e o estado dela na descrição canônica.
Permissão: assets:write. Créditos: uma chamada de visão do Claude Sonnet 4.6 para a descrição, cobrada pelos tokens que usou (como as chamadas de LLM são cobradas). A aprovação nunca é recusada por falta de créditos. Quando o seu saldo é baixo demais para a descrição, a imagem é aprovada mesmo assim e a descrição é pulada. Execute recaption_creature depois para escrevê-la.
| Parâmetro | Tipo | Observações |
|---|---|---|
creature_id | string | Obrigatório. A criatura. |
candidate_job_id | string | Obrigatório. Uma tarefa de imagem concluída feita por você, como um resultado do generate_creature. Uma tarefa feita para outra criatura retorna candidate_creature_mismatch. |
expected_updated_at | string | O updatedAt da criatura. Quando a criatura mudou desde então, a chamada retorna concurrent_modification. |
Retorna: a URL da imagem principal e a descrição. Quando a descrição falha, execute recaption_creature.
recaption_creature
Faz o modelo de visão descrever de novo a imagem principal atual, em cerca de 80 a 120 palavras, e salva o texto como descrição canônica.
Permissão: assets:write. Créditos: uma chamada de visão do Claude Sonnet 4.6, cobrada pelos tokens que usou, como a descrição da aprovação.
| Parâmetro | Tipo | Observações |
|---|---|---|
creature_id | string | Obrigatório. A criatura. |
Retorna: a nova descrição. main_image_required quando a criatura não tem imagem principal, e caption_failed quando a descrição falha.
generate_creature_motion
Anima uma criatura num clipe curto de repouso, como “criatura respirando com um leve balanço em repouso”, uma caminhada furtiva, um bater de asas ou uma panorâmica com paralaxe.
Permissão: workflows:execute. Créditos: o preço do modelo de vídeo. O padrão, Kling 2.5 Turbo Pro, faz um clipe de 5 segundos por 138 créditos.
| Parâmetro | Tipo | Observações |
|---|---|---|
motion_prompt | string | Obrigatório. O movimento da criatura ou da câmera, com até 2.000 caracteres. |
source_image_url | string | Obrigatório. O primeiro quadro, normalmente a imagem principal aprovada da criatura. |
name | string | Obrigatório. O nome da criatura. |
provider | string | kling-turbo (padrão), kling, kling-3.0, minimax, hailuo-2.3, wan-i2v, seedance-2-mini ou bytedance-lite. |
aspect_ratio | string | 1:1 (padrão), 3:4, 16:9, 9:16 ou 4:3. |
attach_to_creature_id | string | Salva o clipe nos clipes de movimento da criatura. A posse da criatura é verificada antes que qualquer crédito seja reservado. |
attach_name | string | O nome do clipe salvo. |
refine_from_video_url | string | Refina um clipe existente com um novo prompt, como vídeo para vídeo. |
canonical_description, category, style | string | Contexto extra para o prompt. |
Retorna: um ID de tarefa. O cartão reproduz o clipe quando ele fica pronto.
Perguntas frequentes
Um assistente pode criar um novo objeto ou uma nova criatura?
Não como um registro salvo. Não existe ferramenta de criação de objetos nem de criaturas; crie-os no app. Depois, o assistente pode listá-los, lê-los, gerar imagens e clipes para eles e aprovar as imagens principais feitas para eles.
Por que a aprovação de uma imagem principal falha com um erro de incompatibilidade?
Uma tarefa candidata feita para outro objeto ou outra criatura retorna candidate_object_mismatch ou candidate_creature_mismatch. Um candidato sem vínculo com nenhum registro, como um resultado do generate_object, pode ser aprovado.
Que clipes de movimento posso fazer de um produto?
Clipes curtos, como uma rotação lenta de 360 graus, um objeto flutuando com uma leve oscilação ou uma panorâmica com paralaxe. generate_object_motion usa enquadramento quadrado e o Kling 2.5 Turbo Pro por padrão.
Qual é a diferença entre um objeto e uma criatura?
Um objeto é um adereço, um produto, um veículo ou outro item físico. Uma criatura é um animal ou um ser não humano, com uma espécie em texto livre, como dragão ou lobo, e variações de pose em vez de variações de material.
Páginas relacionadas
Objetos e adereços
Animais e criaturas
Objeto/adereço
Animal/criatura
Personagens
Última atualização
Locais
Crie locais num assistente de IA, gere e aprove planos de estabelecimento, adicione variações de hora do dia, tempo e ângulo e anime clipes de atmosfera.
Sequência de tomadas e Diretor de vídeo
Parâmetros do Diretor de vídeo, que cria um vídeo narrado de gráficos animados numa chamada, e da sequência de tomadas, que alinha revelações à narração.