UNPKG

@sogni-ai/sogni-creative-agent-skill

Version:

Sogni Creative Agent Skill: agent skill and CLI for Sogni AI image, video, and music generation.

119 lines (94 loc) 5.7 kB
# Private Mature-Theme Video Reference Use this reference for lawful adult mature-theme video requests. ## Routing Prefer `ltx23-22b-10eros-v1.4-fp8mixed_i2v` (`10eros`) for this use case. It is a fast LTX image-to-video model with generated audio. It accepts a first frame, a last frame, or both, and requires `--no-filter`. Use `dr34ml4y-v3` at strength 1 with 10Eros by default. It improves mature-theme prompt adherence, motion, and physical behavior even when no action token is needed. Omit it only when the creator requests the base 10Eros model alone or when comparing/troubleshooting the model and LoRA separately. The LoRA supports: - `ltx23-22b-fp8_i2v` - `ltx23-22b-fp8_i2v_dev` - `ltx23-22b-10eros-v1.4-fp8mixed_i2v` (preferred) Sogni installs the LT3X v3 LoRA, not the separately trained WAN release. Do not use this LoRA ID with WAN models. ## Specialized prompt vocabulary The LoRA is one multi-concept adapter. Each token selects an action concept: | User intent | Token | |-------------|-------| | Missionary position | `m15510n4ry` | | Oral action | `bl0wj0b` | | Two-person oral action | `d0ubl3_bj` | | Rear-entry position | `d0gg1e` | | Partner-on-top position | `c0wg1rl` | | Reverse partner-on-top position | `r3v3rs3_c0wg1rl` | Use one matching token for a clip focused on one action. Multiple tokens can be used for sequential actions, but results may blend the concepts. For more reliable output, render one action per clip and stitch the clips. When a single continuous transition is preferred, keep the sequence short, describe it chronologically, and place each token beside its corresponding action. ## Prompt construction for 10Eros + DR34ML4Y Write the prompt solely to produce the result the creator requested. Use one unbroken, chronological LTX paragraph of 4-8 present-tense sentences. Do not emit section labels such as `Performance:` or `Dialogue:` into the model prompt; fold those details into cinematic prose instead. 1. Use the supplied start image exactly as the first frame by passing it through `--ref`; do not merely mention it in prose. Briefly anchor its composition, subject placement, and starting pose without inventing conflicting details. 2. Establish the overall cinematic style, shot scale, camera movement, environment, lighting, atmosphere, and relevant subtle background motion. 3. State the action concretely. Include a LoRA token when the requested action matches one of its trained concepts. 4. Describe what happens step by step in chronological order: who moves, which body parts move, their direction, changes in position or contact, and the resulting pose. 5. Direct the performance through observable behavior: posture, breathing, gaze, facial expression, micro-expressions, small pauses, and emotional changes that flow naturally from the starting pose. 6. Integrate the audio design with the action: voice delivery, dialogue, foley, environmental sound, and music where relevant. Be specific and literal. Do not substitute euphemisms or generalizations for the requested visible action. Keep the action density appropriate for the duration, and avoid contradictory positions, unrelated cuts, generic quality tags, and repeating the same action in several different ways. Prefer one simple, logical, interesting motion evolution. Keep acting and physical motion natural and cinematic, with realistic weight and restrained gestures rather than exaggerated motion or slapstick. Do not introduce extra characters unless they are clearly visible in the supplied image or explicitly requested. When an image is attached and the creator says "one for this image", "make one for this", or similar, treat the image as the start-frame authority and build the complete purpose-written prompt from what is visibly present plus the creator's stated intent. Do not answer with generic prompting advice, and do not invent a different scene merely to fill out the paragraph. Write every spoken line verbatim in double quotes and identify who says it and how. Never imply dialogue with a summary such as "they talk" or "she says something." Keep dialogue concise enough to fit the clip and coordinate sounds with the motion that produces them. For first+last keyframes, describe the exact continuous change that connects the supplied boundaries rather than reimagining either endpoint. For last-frame-only generation, describe the preceding motion and composition that must resolve naturally into the supplied final frame. For a same-frame loop, describe motion that departs from and settles back into that boundary pose. Action tokens are optional: attach the LoRA for its broader domain improvement even when none of its specialized concepts apply. Generate multiple seeds for difficult poses, transitions, or multi-action clips. ## Frame modes and loops - First-frame animation: `--ref ./first.png` - Last-frame-directed animation: `--ref-end ./last.png` - First-to-last interpolation: use both `--ref ./first.png` and `--ref-end ./last.png` - Single-render anchored loop: use the same image as both the first and last frame, or use deliberately matching boundary frames. Do not add `--looping` to this form. - Automatic two-clip loop: use `--looping --ref ./first.png`. The CLI generates A→B and B→A and joins them; this mode creates its own return endpoint and therefore does not accept `--ref-end`. The optional DR34ML4Y LoRA works with each compatible 10Eros frame mode. Command shape: ```bash sogni-agent --video --ref ./start.png -m 10eros \ --lora dr34ml4y-v3 --lora-strength 1 --no-filter \ "<purpose-built LTX prompt matching the creator's intended result>" ```