moai-media| 3D · Audio · Video analysis · Post-processing (core:media-higgsfield-core)
Overview
media-higgsfield-image와 media-higgsfield-videoIf "Create new images and videos" handles that, this skill handles the four areas outside it: 3D assets, audio, finished video analysis, and post-processing of existing assets.
The call contract, cost preflight, and namespace resolution follow the core:
- Call contract:
../media-higgsfield-core/references/call-schema.md - Live lookup:
../media-higgsfield-core/references/catalog-protocol.md - Jobs, costs, and readback:
../media-higgsfield-core/references/job-lifecycle.md
Trigger keywords
3D, GLB, mesh, rigging, skeleton, 3D modeling, texture, PBR, sound effects, SFX, ambience, background music, BGM, narration, TTS, speech synthesis, voice, viral prediction, hook score, video analysis, upscale, 4K, reframe, outpainting, background removal, cutout
Four areas and entry points
| Area | What it does | Details |
|---|---|---|
| 3D | Image/text → GLB mesh, rigging, animation | references/3d.md |
| Audio | Sound effects, ambience, music, TTS | references/audio.md |
| Analysis | Attention, hook, and retention scores of finished videos | references/analysis.md |
| Post-processing | Upscaling, reframing, outpainting, background removal, motion | §Post-processing below |
Workflow
Follow the core REQ-010 flow exactly. Only the area differs; the order is the same.
- Intent → narrow down the area and candidates. Choose the area from the table above, and narrow down candidate models using the relevant reference file. Do not assume parameters.
- Live lookup.
models_explore(action:'get')Fetch the actual constraints with . For 3D and audio, parameter variation between models is greater than for images and videos, so skipping this step almost always fails. - Cost preflight.
get_cost: true로creditsConfirm. For 3D, texture, rigging, and animation each cost extra, so check the cost with the options enabled. - Approval gate. Stop before credits are spent — follow the core §Paid generation approval gate exactly. Show the full prompt, model, input media, options, count,
adjustmentsand estimated credits, and obtain approval. If texture, rigging, and animation options were enabled for 3D, show the additional cost for each option separately — showing only the total makes it impossible to tell which option is expensive. - Generation. Call only with approved values.
- Polling and readback.
job_statusuntil completion.adjustmentsIf present, report it to the user.
Post-processing (modifying existing assets)
This is the case of modifying an existing asset rather than creating a new one. Each task has a dedicated tool, so do not try to reproduce the same result with a generative model — the dedicated tool is cheaper and the results are more stable.
| Request | Dedicated tool |
|---|---|
| Increase resolution (image) | Image upscale |
| Increase resolution (video) | Video upscale |
| Expand canvas / remove crop | Outpainting |
| Change video aspect ratio (landscape↔portrait) | Reframe |
| Remove background / transparent background | Remove background |
| Motion transfer / recast / puppet | Motion control |
Input is passed in the same way as the core rules, via media_id or the previous job's job_id. Raw URLs are rejected.
Output format
## Higgsfield 에셋 생성 결과
- 영역: [3D | 오디오 | 분석 | 후처리]
- 모델·도구: [models_explore로 확인한 실제 id]
- 적용 옵션: [텍스처·리깅·애니메이션 / 포맷·샘플레이트 / 등]
- 비용: [get_cost가 반환한 credits]
- Job ID / 결과 URL: [job_status completed]
- 서버 조정(adjustments): [있으면 그대로 보고]
Cautions
- 3D의
enable_animation은enable_riggingis required, and texture-related options requireshould_texture. Violating the dependency relationships is an error (→references/3d.md). - Rigging is tailored to humanoids. Animals and objects may produce poor rigging results, and this fact is disclosed in advance.
- Some audio models are declared in the live schema as game pipeline only. Do not select them as the default for general-purpose requests (→
references/audio.md). - Video analysis does not create media and returns a text report. Do not let users expect generated output.
- Do not guess model ids or parameters — always verify with
models_explore. - Do not clone another person's voice without consent.
Related skills
| Skill | Perspective |
|---|---|
moai-media:media-higgsfield-core |
Core: invocation contract, cost, namespace |
moai-media:media-higgsfield-image |
Prerequisite: image generation for 3D input |
moai-media:media-higgsfield-video |
Prerequisite: video generation for analysis and post-processing targets |
moai-media:media-higgsfield-explainer |
Follow-up: assemble audio and clips into an explanatory video |
moai-media:media-audio-gen |
Alternative: ElevenLabs-based TTS and dubbing |
moai-marketer:marketing-performance-report |
Follow-up: reflect analysis scores in the performance report |
Source
- Higgsfield Skills (official agent documentation) —
higgsfield-generatev0.12.0 (MIT). Basis for area classification and viral analysis interpretation criteria. - Live MCP schema observation (
models_exploretype=3d / type=audio) — basis for the model list, parameters, dependency relationships, and game-pipeline-only notation. Evidence tier: 1차. - The actual parameters are the runtime
models_exploreis the only source of truth. Values in reference files are snapshots at the time of writing.