Executes AI visual asset generation using prompts from visual-asset-prompt-generator. Calls fal.ai (Nano Banana/Flux 1.1 Pro) for images and Hunyuan3D (via Blender MCP or HuggingFace) for 3D models. Handles async polling and asset post-processing.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.
Executes AI visual asset generation using prompts from visual-asset-prompt-generator. Calls fal.ai (Nano Banana/Flux 1.1 Pro) for images and Hunyuan3D (via Blender MCP or HuggingFace) for 3D models. Handles async polling and asset post-processing.
Visual Asset Generator
Takes structured prompts from visual-asset-prompt-generator and generates actual visual assets via AI APIs. Manages async 3D generation, image downloads, and asset organization.
When to Use
After visual-asset-prompt-generator has produced prompts JSON
User says "generate the images", "create the 3D models", "run the asset pipeline"
As Step 2 of the brand-visual-pipeline
Input Variables
[BRAND_NAME] — Brand name (for directory paths)
[PROMPTS_FILE] — Path to prompts JSON from Skill 1 (default: brands/{BRAND_NAME}/visual-prompts.json)
{"brand":"[BRAND_NAME]","generated_at":"ISO_DATE","assets":[{"asset_id":"hero-001","type":"hero-image","service":"fal-flux","status":"completed","files":{"primary":"images/hero-shots/hero-001.png","webp":"images/hero-shots/hero-001.webp","thumb_800":"images/hero-shots/hero-001-800.png","thumb_400":"images/hero-shots/hero-001-400.png"},"dimensions":{"width":1920,"height":1080},"prompt_used":"the prompt that was used","generation_params":{ ... }},{"asset_id":"model-001","type":"3d-model","service":"hunyuan3d","status":"completed","files":{"glb":"3d-models/model-001/model.glb","render":"3d-models/model-001/render.png"},"job_id":"job_xxx"}]}
Error Handling
Error
Action
fal.ai 401
Check FAL_KEY env var, report to user
fal.ai 429
Retry with exponential backoff (max 3 retries)
Hunyuan3D timeout (>10 min)
Fall back to HF API or report
Blender not connected
Use HF API fallback
Image download fails
Retry once, then skip with warning
Scripts
scripts/fal_client.py
fal.ai API client for Flux 1.1 Pro and Nano Banana image generation.
scripts/fal_3d_client.py
fal.ai 3D model generation client. Supports four modes:
# Text to 3D (Hunyuan3D V3) — $0.375/gen, ~2 min, PBR materials
python scripts/fal_3d_client.py --mode text-to-3d --prompt "a leather journal" --output ./output/
# Image to 3D (Hunyuan3D V3) — $0.375/gen, ~2 min
python scripts/fal_3d_client.py --mode image-to-3d --image-url "https://..." --output ./output/
# Image to 3D (TripoSR) — $0.07/gen, <1s, lower quality
python scripts/fal_3d_client.py --mode triposr --image-url "https://..." --output ./output/
# Image to 3D (Hunyuan3D V2) — $0.16/gen
python scripts/fal_3d_client.py --mode hunyuan-v2 --image-url "https://..." --output ./output/
Hunyuan3D V3 extra options:
--enable-pbr — PBR materials (default: true)
--face-count 100000 — Target polygon count
--generate-type Normal|LowPoly|Geometry
Output: GLB, OBJ, and preview PNG files in the specified output directory.
scripts/hunyuan_generate.py
HuggingFace API client for Hunyuan3D when Blender MCP and fal.ai are unavailable.
