Produção

Vídeos

Vídeos verticais (9:16) do produto, com a fala escolhida automaticamente pelo sistema.

Apresentação e CinePremium#

	Apresentação	CinePremium
`tipo` no pedido	`apresentacao`	`cinepremium`
Tipo na conferência	`video_apresentacao`	`video_cinepremium`
Requisitos	nota de vídeo 5 ou mais e 1 foto sem pessoa	tudo da Apresentação e 3 fotos de lados diferentes; roupa e calçado com 2 fotos da peça sem pessoa
`avatar`	`automatico` (padrão) ou o código de um avatar oficial	não se aplica
`voz`	não se aplica (é a voz do avatar)	`automatica` (padrão), `masculina` ou `feminina`
`formato`	`9:16`	`9:16`

Requisitos completos em Requisitos da ficha.

Avatares#

Na Apresentação, o seu cliente pode escolher quem apresenta o produto. Monte a escolha no seu sistema com GET/avatares: a lista traz só os avatares ativos, com codigo, nome, genero, idadeAparente, foto (retrato vertical) e previaAnimada (vídeo curto, sem som). Consultar é grátis e não gasta crédito; a resposta pode ficar guardada por 5 minutos.

bash

curl -s $B/avatares -H "Authorization: Bearer $K"

Envie o codigo escolhido no campo avatar de POST/videos. Sem o campo, ou com avatar: "automatico", o sistema escolhe pelo produto. Código que não existe ou não está ativo responde 400 VALIDATION_ERROR com o campo avatar e o código AVATAR_INDISPONIVEL, e nada é reservado.

Guarde a foto e a prévia no seu sistema (baixe e sirva do seu domínio) e atualize a lista de vez em quando: um avatar pode sair de linha e outros podem entrar.
Produto de vestir: prefira um avatar do mesmo público da peça. Se não for, a peça é apresentada nas mãos, nunca vestida.
O CinePremium não tem avatar: escolha a voz (masculina, feminina ou automatica).

Catálogo de hoje (a fonte que vale é sempre GET/avatares):

Nome	Código	Gênero
Bruno	`h01`	masculino
Diego	`h02`	masculino
Rafael	`h03`	masculino
Marcelo	`h04`	masculino
Sérgio	`h05`	masculino
Paulo	`h06`	masculino
Caio	`h07`	masculino
Thiago	`h08`	masculino
Rodrigo	`h09`	masculino
Fábio	`h10`	masculino
Beatriz	`m01`	feminino
Camila	`m02`	feminino
Juliana	`m03`	feminino
Adriana	`m05`	feminino
Simone	`m06`	feminino
Sônia	`m07`	feminino
Vera	`m08`	feminino
Larissa	`m09`	feminino
Eliane	`m14`	feminino
Amanda	`m17`	feminino

Pedir#

bash

curl -s -X POST $B/videos -H "Authorization: Bearer $K" \
  -H "Idempotency-Key: $(uuidgen)" -H 'content-type: application/json' \
  -d '{"produtoId":"prd_01J9Z7A1B2C3D4E5F6G7H8J9K0","tipo":"apresentacao","avatar":"automatico","referenciaExterna":"pedido-erp-55121"}'

POST/videos responde 202 com o id da geração. Acompanhe por aviso ou por GET/geracoes/{geracaoId}, como na galeria.

Exige a versão atual aprovada na conferência para o tipo; senão 422 e nada é reservado.
Um vídeo por produto por vez: outro pedido para o mesmo produto em produção responde 409.
Vídeos simultâneos: o plano define quantos rodam ao mesmo tempo. Passou disso, o pedido espera na fila (na_fila, com posição e tempo estimado) e começa sozinho; nenhum pedido é recusado por capacidade.
Enquanto está na_fila, dá para cancelar. Depois que a geração começa, o vídeo não pode ser cancelado.

Fala automática#

Para integradores não existe escolha manual da fala, nem endpoint para isso. O sistema gera as opções de fala e escolhe a melhor que passou nas travas de qualidade:

Só contam as opções que passaram nas travas: fato que a ficha não prova, chamada para ação inválida, fato repetido entre cenas e duração da narração.
Entre elas, vence a de maior nota do crítico, quando a revisão existe.
Empate: a opção recomendada pelo motor e, depois, a mais segura (safe). No CinePremium, empate fica com safe.

A fala usada volta na geração, em fala (assim que a escolha acontece) e em resultados.video.fala:

json

{
  "fala": {
    "texto": "…",
    "escolha": "automatica",
    "opcoesConsideradas": 2,
    "tom": "safe",
    "criterio": "sellume.integradores.fala_automatica.v1"
  }
}

Quando nenhuma fala passa#

Se nenhuma opção passar nas travas, a geração falha antes de qualquer custo: nada é renderizado e os créditos voltam inteiros. A geração fica falhou, o aviso geracao.falhou é enviado e o campo erro.type vem como VIDEO_SPEECH_NOT_APPROVED. Enriqueça a ficha (características, avaliações, perguntas, garantia), confira de novo e peça outro vídeo.

Resultado#

resultados.video traz:

Campo	O que é
`url`	link assinado e temporário do MP4 (vale 7 dias)
`expiraEm`	quando o link vence; consulte a geração de novo para um link novo
`capaUrl`	capa do vídeo, quando houver
`duracaoSegundos`, `largura`, `altura`	medidas do vídeo
`fala`	a fala usada (acima)

No teste (sk_test_) volta um vídeo de exemplo em cerca de 15 segundos, com a escolha da fala simulada pela mesma regra e sem gastar crédito.

Com créditos de teste liberados pelo Sellume, "modo": "real" com a chave sk_test_ gera o vídeo de verdade (fala automática real) e gasta só os créditos de teste; veja Galerias.

Cobrança#

Os créditos são reservados no pedido e cobrados na entrega, no preço do seu contrato. Falha do Sellume ou fala não aprovada devolve tudo. Sem crédito: 402 INSUFFICIENT_CREDITS, nada cobrado.