Skip to main content

Guia do Usuário do HappyOyster

Guia do usuário do modelo de mundo HappyOyster: capacidades, vitrines e escrita de prompts para os modos Aventura, Direção e Atuação.

Visão geral

O HappyOyster é uma série de modelos de mundo aberto — forneça texto ou uma imagem e ele gera um mundo digital interativo em tempo real, abrangendo três modos: Aventura, Direção e Atuação. Visite o site do HappyOyster para experimentar online:
ModoO que fazEntradaSaída
Aventura (Exploração de Mundo)Entre em um mundo gerado em primeira ou terceira pessoa; mova-se, lute e cavalgue livrementeTexto + imagem do primeiro quadroStream de vídeo interativo em tempo real
Direção (Direção em Tempo Real)Transmita um vídeo de 3 minutos; injete comandos a qualquer momento para mudar a históriaTexto / imagem do primeiro quadro / referência de múltiplas imagensStream de vídeo interativo em tempo real com pausa, retrocesso e ramificação
Atuação (Interpretação de Personagem)Converse cara a cara com um personagem gerado que responde com expressões, ações e vozTexto + imagem do primeiro quadroStream de vídeo interativo em tempo real

Aventura (Exploração de Mundo)

A partir da entrada de texto + imagem do primeiro quadro, ele gera uma cena de mundo aberto de qualquer estilo com múltiplas formas de interação. Suporta visões em primeira e terceira pessoa com movimento em tempo real e controle de câmera. Uma imagem mais uma linha de descrição é tudo o que você precisa para entrar em um mundo onde pode se mover, lutar e interagir, por exemplo, cavalgar, voar, dirigir e explorar mundos de diferentes estilos. Defina o que você want jogar no momento da criação, e o mundo responderá de acordo.

Demonstrações

Comparação de perspectiva

Primeira pessoaTerceira pessoa
Exploração imersiva em POV — adequada para direção e furtividade.Veja o corpo inteiro do seu personagem — adequado para ação e aventura e interpretação de papéis.

Interação com reconhecimento de cenário

O modelo entende o que está no quadro e abre uma jogabilidade correspondente com base nos objetos da cena.
Movimento do sujeitoInteração ambientalResposta física
Correr, pular, agachar, atacar (varia conforme o tipo de personagem)Entrar em veículos, acionar mecanismos de cenaColisão, ricochete, gravidade e outros feedbacks físicos

Estilos de mundo

Suporta geração de mundos em qualquer estilo. Aqui estão alguns exemplos:
Jogo da Ilha de FeltroEspaço-Caminhada LunarFantasia-Voo
Renderização de material de desenho animado, exploração não realistaFísica de baixa gravidade, interação com cenário espacialVoo, vassoura voadora e outras interações de fantasia
Montaria em animaisCombate e ataquesVeículos
Montar, desmontar, controle de montariaSocos, arcos, armas de fogo, magiaCarros, bicicletas, skates

Interações

CapacidadeDescrição
Movimento do sujeitoCorrer, pular, agachar, atacar (varia conforme o tipo de personagem)
CombateSocos, arcos, armas de fogo, magia; luta solo/em dupla
Montarias e veículosMontar/desmontar cavalos; carros, bicicletas, skates
Interação ambientalEntrar em veículos, resposta de colisão física
Estilos de mundoRealista, anime, feltro, espaço, fantasia — qualquer estilo
PerspectivaPrimeira pessoa (POV imersivo) / terceira pessoa (ação e aventura)

Escrita de prompts

Dois princípios fundamentais: primeiro, o que estiver na cena é o que você poderá usar para interagir; segundo, qualquer reação que você want, escreva a reação também. Objetos que você não escrever não poderão ser usados, e reações que você não escrever não serão executadas. Escreva a descrição da sua criação seguindo estes 5 pontos e a interação corresponderá melhor às suas expectativas:
  1. Perspectiva: Primeiro decida entre primeira pessoa ou terceira pessoa. A primeira pessoa é adequada para direção imersiva e exploração em POV; a terceira pessoa permite que você veja seu personagem, sendo adequada para ação e aventura e interpretação de papéis.
  2. Quem você interpreta: Especifique o gênero / identidade / aparência do personagem principal (por exemplo, "uma guerreira com armadura de couro"). Isso é especialmente importante para a terceira pessoa, pois a aparência do personagem determina diretamente o estilo de movimento.
  3. Armas / equipamentos: Se você want lutar ou atacar, declare o que tem em mãos: punhos / arco longo / arma de fogo / magia / espada. Itens diferentes significam ações disponíveis diferentes.
  4. Oponente e reação: Além de declarar quem você atinge, descreva "o que acontece após um acerto": o oponente tropeça para trás / cai com o impacto / levanta um escudo para bloquear, além dos efeitos de impacto que você want (faíscas, chamas jorrando, uma onda de choque). O modelo executa a reação que você escreve — quanto mais específica a reação e os efeitos, mais forte a sensação de impacto.
  5. Objetos interativos: Se você want montar ou dirigir, faça o cavalo, carro, bicicleta, skate, etc. aparecerem no quadro. Se um objeto não estiver no quadro, você não poderá subir nele.
Exemplos de prompts Terceira pessoa-Ação e aventura
Third-person view: a female warrior in leather armor stands at the center of
an arena, holding a longbow, as a giant wolf lunges at her; sparks burst when
the arrow lands, the wolf flinches and stumbles back in pain, dust kicks up
from the sand, and the stands are packed with spectators.
Interações disponíveis: sacar e atirar, desviar, lutar de perto — os acertos produzem faíscas e as reações de acerto do lobo. Primeira pessoa-Dirigir imersivo
First-person view: I sit in the driver's seat of a vintage classic car, both
hands on the wheel, a dusk coastal highway ahead; the engine roars as I hit the
gas, and the wheels kick up dust from the road.
Interações disponíveis: acelerar, dirigir, pilotar pela rodovia — com som do motor e feedback de poeira ao acelerar. Exemplo de referência
Primeiro quadroPromptVídeo gerado
Sobrevivência pós-apocalíptica
Visuais de jogo cinematográficos realistas. Visão em terceira pessoa por cima do ombro, um homem com uma jaqueta de couro escura e desgastada está em uma estrada de terra em uma vila abandonada, com uma espingarda erguida em postura de combate. Na névoa distante, várias criaturas humanoides distorcidas se aproximam lentamente. Ao seu redor, há casas de madeira desmoronadas, um moinho de vento em ruínas e lenha empilhada. O céu está nublado e sombrio, a atmosfera geral é opressiva e assustadora, com tons principalmente de marrom-acinzentado e verde-escuro.

Direção (Direção em Tempo Real)

A partir de texto, uma imagem do primeiro quadro ou várias imagens de referência, ele transmite um vídeo de até 3 minutos de duração. Injete comandos a qualquer momento durante a geração para mudar o rumo da história; suporta pausa, retrocesso e ramificação. Use imagens enviadas como referência para fixar a aparência do personagem/adereço para total consistência.

Demonstrações

Narrativa

Cena com um personagemCena com dois personagens
Monólogo de um personagem ou cena de ação.Diálogo entre dois personagens, textura cinematográfica realista.

Interação imersiva em POV

Exploração ao ar livre em POVInteração com personagem realista
Exploração em primeira pessoa por ambientes ao ar livre.Interação em tempo real face a face com personagens realistas.

Capacidades principais

CapacidadeDescrição
Geração em streamingGeração e reprodução em tempo real, sem necessidade de esperar pela renderização completa
Injeção de comandosInsira novos comandos a qualquer momento durante a geração para alterar as ações do personagem, o trabalho de câmera ou o ambiente da cena
Pausar e retrocederPause e continue, ou retroceda para qualquer ponto e refaça
Referência multimodalReferencie imagens enviadas para fixar a aparência do personagem/adereço por 3 minutos de consistência
Tipos de injeção de comandos
TipoExemploObservações
Gatilho de ação"Ela se levanta de repente." / "Ele coloca o copo na mesa."Ação curta e clara, mais confiável
Trabalho de câmera"Corte para um close-up do rosto." / "Afaste a câmera lentamente."Termos cinematográficos são mais precisos
Mudança de cena"Começa a chover." / "O tempo salta para o anoitecer."Injete uma variável de ambiente para mudar o clima
Novo personagem"A porta é empurrada e aberta, um homem de chapéu preto entra."Detalhe a aparência e a primeira ação

Escrita de prompts

Um vídeo de 3 minutos precisa de um roteiro estruturado. Recomenda-se uma estrutura de prompt em seis partes:
ParteNomeObjetivo
1MundoTempo-espaço + gênero + conflito central, 1-2 frases para definir a coordenada narrativa
2PersonagemGênero/idade/aparência/roupa/personalidade/emoção/voz — 7 essenciais + imagens de referência para fixar a aparência
3EstiloDiretor / gradação de cor / iluminação — três âncoras
4CenaTipo de cena / clima ambiente / layout / som ambiente — quatro dimensões
5Roteiro completoBloqueio de configurações (BLOQUEIO de ponto de vista/sujeito/voz/ritmo) + plano de tomada (Abertura/Desenvolvimento/Virada/Sustentação/Fechamento — 5 atos)
6Lista negativaElementos de imagem/som que não devem aparecer
Seção por seção
① World-Time-space + genre + core conflict
Sentence skeleton: [Year + season], [city / specific location], the genre is [narrative style], the core conflict is [one-line conflict].

② Character-7 essentials + consistency
1-Basics — gender / age / build / temperament
2-Appearance — hairstyle & color / facial features / key identifiers (scar / mole / glasses)
3-Clothing — top / bottom / shoes / accessories; the more specific, the more stable the consistency
4-Identity — occupation / class / social role
5-Personality — 1-2 keywords (reserved-hot-tempered-outwardly tough)
6-Current emotion — what they're thinking, bothered by, or waiting for in this moment
7-Voice / timbre — gendered voice + age range + accent + overall feel; a must for multi-character scenes

③ Style-Three anchors: director / color grade / lighting
1-Director / genre anchor — "Japanese family-drama texture," "Hong Kong neon light and shadow," "hard-edged cold-tone sci-fi"
2-Color grade — "warm gold tone, low saturation," "cool blue base + neon highlights"
3-Lighting type — "natural light dominant," "hard top light," "side back-light from a window"

④ Scene-4 dimensions + key-item reference
1-Scene type (indie indoor café / abandoned suburban factory / ancient inn hall / school rooftop)
2-Ambient mood (warm and relaxed / crowded and noisy / cold and oppressive / quiet and suspenseful)
3-Layout (table & chair placement / key prop positions / spatial depth / main furnishings)
4-Ambient sound — 2-3 specific sounds (indoor BGM + distant nature sound + occasional voices)

⑤ Full script-Settings lock + shot plan
a) Settings lock-6 recommended LOCKs
  VIEWPOINT LOCK  Use a single viewpoint throughout; no switching
  POV SELF-LOCK   In POV, "my" face / full body / mirror reflection never appears
  CAST LIMIT      ≤ 3 subjects in frame at once
  SUBJECT LOCK    Character clothing / hairstyle / props unchanged for 3 minutes
  VOICE LOCK      In multi-character scenes, each voice stays fixed; no swapping
  PACE LOCK       No single silence / pause exceeds 2 seconds

b) Shot plan-5 shots × 4 frames
  Open   [0:00-0:10] HOOK — strong opening, no flat exposition
  Build  [0:10-0:50] Establish character relationships; introduce the first variable
  Turn   [0:50-1:40] The film's one and only surprise (reversal / conflict / choice)
  Sustain[1:40-2:30] Emotional breathing room; density can thin but never fully silent
  Close  [2:30-3:00] End on one image / one line / one action; throw an interaction hook

  Each shot specifies:
  [Context] What's happening + where the lead is and what they're doing + visual anchor
  [Key lines] Format: CharacterName(voice cue) "line"; in multi-character scenes, mark the speaker
  [Pacing] Verifiable hard metrics, e.g., "at least 2 lines in 10 seconds"

⑥ Negative list-What not to show
Only state special taboos that can't be derived from the settings lock; don't repeat positive settings.
Image taboos: e.g., "no night scenes / rain / cars"
Sound taboos: no post-production voiceover / narration / BGM drowning out voices

Atuação (Interpretação de Personagem)

A partir da entrada de texto + imagem do primeiro quadro, ele gera um personagem virtual face a face. Quando você fala, o personagem responde em tempo real com expressões, ações e voz, enquanto a aparência, a voz e a personalidade permanecem consistentes por 3 minutos. Envie uma imagem para dar vida ao personagem em sua mente e iniciar uma conversa em tempo real.

Demonstrações

A interação principal da Atuação é "você e o personagem, face a face" — você fala, e o personagem responde em tempo real com expressões, ações e falas. Ao longo da sessão, o personagem é sempre a mesma pessoa.
Realista-Face a face2D estilizado-Companheiro
Personagem realista; expressões e tom de voz mudam naturalmente com a conversa; aparência fixa durante toda a interação.Personagem estilizado em anime/ilustração 2D — também suporta diálogo em tempo real face a face com mudanças naturais de expressão e tom de voz.

Capacidades principais

CapacidadeDescrição
Diálogo em tempo realVocê diz uma fala, o personagem responde instantaneamente com expressões, ações e falas
POV cara a caraVisão padrão em primeira pessoa; a câmera está sempre voltada para o rosto do personagem; o usuário nunca aparece na tela
Consistência de longo alcanceA aparência, roupa, voz e personalidade do personagem permanecem inalteradas por 3 minutos; envie uma imagem para fixar a aparência com precisão
Interação principal
CapacidadeEfeito
Diálogo em tempo realVocê diz uma fala, o personagem responde instantaneamente com expressões, ações e falas — como uma conversa real
POV cara a caraO quadro está sempre voltado para o rosto do personagem; apenas sua mão/antebraço entra no quadro, mantendo a atenção no personagem
Bloqueio de aparênciaEnvie uma imagem para fixar a aparência do personagem e os adereços principais; sem mudanças de rosto ou voz ao longo de tudo
Continuidade emocionalAs expressões e o tom do personagem mudam naturalmente à medida que a conversa avança — não é um modelo fixo

Escrita de prompts

Os prompts de atuação focam no próprio personagem e na sua relação com ele. Estruture ao longo destas 5 dimensões:
DimensãoDescriçãoExemplo
PersonaGênero/idade/aparência/roupa/identidade/personalidade"Uma jovem no início dos vinte anos, cabelos longos, lisos e pretos, vestindo um suéter de tricô creme, gentil e sorridente"
VozVoz generificada + faixa etária + sotaque + temperamento"Voz feminina jovem, brilhante, com um tom nasal levemente tímido"
Relacionamento e cenárioSeu relacionamento com o personagem + cena atual"Namorados, um café à beira da janela ao anoitecer, luz amarela quente"
Bloqueio de ponto de vistaPOV + características da "minha" mão"Durante todo o tempo, apenas ela e minha mão direita entram no quadro (homem adulto, nós dos dedos bem definidos)"
AberturaA primeira ação e a primeira fala do personagem"Ela apoia o queixo na mão, olha para mim e diz com um sorriso: 'Você chegou cedo hoje'"
Exemplo de prompt
First-person face-to-face view. Opposite me is a young woman in her early
twenties, long straight black hair, wearing a cream knit sweater, gentle and
smiley; young female voice, bright, with a slightly coy nasal tone.
We are lovers, right now in a café by the window at dusk, warm yellow light.
She rests her chin on her hand, looks at me, and says with a smile:
"You're here so early today."
Throughout, only she and my right hand enter frame (adult male, well-defined
knuckles, no accessories); my face and reflection never appear.
Interação: converse com ela em tempo real, brinque, entregue uma xícara a ela — ela responde com expressões, ações e tom de voz.

Próximos passos

Depois de conhecer os três modos, consulte a Visão geral do HappyOyster para integrar via API / SDK.