Um personagem é uma sheet de cinco vistas da mesma pessoa (ou criatura), feita a partir de uma foto e guardada com um character_id. É o que o Multi-Ref Vídeo usa para reconhecer alguém num clip: as cinco vistas transportam a semelhança, sem qualquer treino.

Os personagens que criaste na app já estão disponíveis: mesma licença, mesma lista (ver Personagens da app).

As cinco vistas

Papel	Vista
1	Busto de frente, expressão neutra
2	Busto ¾, o personagem olha para a direita da imagem, sorriso ligeiro
3	Busto ¾, o personagem olha para a esquerda da imagem, neutro
4	Corpo inteiro de frente
5	Corpo inteiro, de costas

Cada vista é gerada de forma independente: nenhuma é obtida por inversão de outra.

Criar um personagem

POST /characters (permissão images). O trabalho é assíncrono.

json

{ "name": "Lea", "kind": "woman", "image_b64": "<the photo>", "photo_role": "bust" }

Campo	Tipo	O que faz
`name`	string, 1 a 40 caracteres	O primeiro nome do personagem
`kind`	string	`woman`, `man`, ou uma criatura descrita em inglês (`baby dragon`). Define os pronomes das instruções, nunca "they".
`image_b64`	base64	A foto: nítida, apenas uma pessoa, mínimo 1024 px no lado maior, máximo 12 MB, JPEG, PNG ou WebP
`photo_role`	`bust` (padrão) ou `full_body`	A foto é um busto (torna-se a vista 1) ou uma foto de corpo inteiro (vista 4)
`outfit`	texto em inglês, opcional	Um traje a colocar primeiro (`a red leather jacket and black jeans`)

A resposta, 202, é o personagem com status pending e cost_estimate. A foto torna-se a vista do seu papel e o servidor gera as outras quatro, em 1 a 3 minutos.

Preço: um crédito por vista gerada, ou seja, 4 créditos, mais 1 com outfit (o traje é colocado primeiro, como passo separado). Uma vista que falhe não é cobrada. POST /characters/quote dá o preço antecipadamente (outfit opcional).

Acompanhar, verificar, refazer

GET /characters/{id} devolve o estado:

`status`	Significado
`pending`	As vistas estão a ser criadas
`ready`	As cinco vistas estão prontas
`partial`	Algumas vistas estão em falta ou falharam
`failed`, `empty`	Nenhuma vista utilizável

json

{
  "character_id": "chr_8f3a...",
  "name": "Lea",
  "kind": "woman",
  "origin": "api",
  "status": "ready",
  "progress": { "ready": 5, "total": 5 },
  "views": [
    { "role": 1, "name": "bust_front", "status": "ready", "file_url": "https://api.tendre.ai/pro/v1/characters/chr_8f3a.../views/1/file" }
  ],
  "expires_at": "2026-10-19T18:02:11.000Z"
}

Verifica as vistas antes do primeiro render. GET /characters/{id}/views/{role}/file devolve a imagem. Uma vista com falha, ou que olhe para o lado errado, compromete a semelhança em todos os vídeos.
Refazer uma vista: POST /characters/{id}/views/{role}/redo, 1 crédito. A vista que vem da foto original não pode ser refeita (vue_photo).
Listar: GET /characters devolve os teus personagens, incluindo os da app, e o limite max.
Eliminar: DELETE /characters/{id} apaga o personagem e as suas vistas.

Personagens da app

Um personagem criado no ecrã Meus personagens da app aparece em GET /characters com origin app, e pode ser utilizado no Multi-Ref Vídeo como qualquer outro. Na app, um personagem pode ter várias sheets (trajes, estados de espírito): sheet_id indica qual é servida (a mais recente por padrão), sheets lista-as, e ?sheet=<id> pede outra na leitura, no ficheiro de uma vista e numa vista refeita. Num clip Multi-Ref, characters[].sheet_id seleciona a sheet. Para refazer uma vista de um personagem da app, inclui o seu kind no corpo.

Armazenamento

As vistas são encriptadas (uma chave por ficheiro) e associadas à tua licença. 50 personagens no máximo com a licença Pro, incluindo os da app. Um personagem sem utilização durante 15 dias é eliminado (expires_at): cada render Multi-Ref e cada leitura de uma vista adiam essa data. A foto que envias é guardada como a vista do seu papel, encriptada, tal como as vistas geradas.

Através de um agente (MCP)

Com o servidor MCP, basta pedires: "cria um personagem a partir desta foto". O agente usa tendre_character_create (a foto chega através de um link de upload, um ficheiro anexado no ChatGPT, uma imagem gerada na conversa ou um endereço público), mostra-te as cinco vistas e refaz uma que tenha falhado com tendre_character_redo_view. tendre_character_get, tendre_character_list e tendre_character_delete cobrem o resto, e tendre_quote dá o preço antecipadamente.

De seguida, coloca o personagem em cena: ver Multi-Ref Vídeo.

Pro API: criar personagens para Multi-Ref Vídeo