Bona Movie Production

---

name: bona-movie-production

description: "Bona Movie Production is Bona Group's film-grade production skill. It covers image generation, image editing, and video generation, using Nano Banana 2 and Nano Banana Pro for images, and Seedance plus generate_video_kling_v3 for videos."

license: MIT

compatibility: "需要 Python 3.9+，依赖 requests。默认请求 https://api.bonanai.com/v1/tencent 。"

metadata:

author: codex

version: "1.0.0"

python-version: ">=3.9"

dependencies:

- requests

tags:

- ai-image

- ai-video

- bona

- movie-production

env:

- name: BONA_API_KEY

required: true

desc: "Bona API Key"

- name: TENCENT_VIDEO_TIMEOUT

required: false

desc: "HTTP 超时时间，默认 600 秒"

---

# Bona Movie Production

这是博纳集团电影级的制作 Skill，包含：

流程：

当前 Skill 只使用四个模型：

使用前先配置环境变量：

export BONA_API_KEY="your_api_key"

一、图片生成

更偏理解能力。适合复杂指令、参考图理解、换视角、文本渲染、多图关系理解。

更偏最终质量。适合高质量成片、商业视觉、海报、封面、九宫格或 5x5 宫格输出。

1. `generate_image_nano_banana_2`

适合：

参数规则：

Prompt 写法：

示例：

python skills/bona-movie-production/scripts/bona_movie_production.py create-image \
  --tool-name generate_image_nano_banana_2 \
  --image-name "hero-character-design" \
  --prompt "A modern bookstore cafe interior with warm wood shelves, soft afternoon sunlight, a handwritten chalkboard menu, calm and inviting atmosphere, editorial interior photography" \
  --task-type TEXT_TO_IMAGE \
  --resolution 2K \
  --aspect-ratio 4:3

2. `generate_image_nano_banana_pro`

适合：

参数规则：

Prompt 写法：

示例：

python skills/bona-movie-production/scripts/bona_movie_production.py create-image \
  --tool-name generate_image_nano_banana_pro \
  --image-name "premium-key-visual" \
  --prompt "A premium skincare bottle on polished black stone, controlled studio side lighting, luxury beauty advertising, sharp reflections, elegant minimal composition" \
  --task-type TEXT_TO_IMAGE \
  --resolution 4K \
  --aspect-ratio 4:5

二、图片编辑

1. `generate_image_nano_banana_2`

适合：

Prompt 写法：

`change only X to Y`

`add/remove X while keeping everything else unchanged`

示例：

python skills/bona-movie-production/scripts/bona_movie_production.py create-image \
  --tool-name generate_image_nano_banana_2 \
  --image-name "character-bg-edit" \
  --prompt "Change only the wall color to muted olive green while keeping the furniture, layout, lighting, and camera angle unchanged" \
  --image-url https://example.com/room.png \
  --task-type EDIT_SINGLE_IMAGE \
  --aspect-ratio 4:3 \
  --resolution 1K

2. `generate_image_nano_banana_pro`

适合：

示例：

python skills/bona-movie-production/scripts/bona_movie_production.py create-image \
  --tool-name generate_image_nano_banana_pro \
  --image-name "fashion-campaign-edit" \
  --prompt "Change only the background to a luxury hotel lobby, keeping the model pose, facial expression, clothing, and lighting direction unchanged, premium fashion campaign look" \
  --image-url https://example.com/model.png \
  --task-type EDIT_SINGLE_IMAGE \
  --aspect-ratio 3:4 \
  --resolution 2K

三、参考图生成

1. `generate_image_nano_banana_2`

适合：

Prompt 写法：

示例：

python skills/bona-movie-production/scripts/bona_movie_production.py create-image \
  --tool-name generate_image_nano_banana_2 \
  --image-name "character-consistency-scene" \
  --prompt "Refer to the first image for the character appearance and the second image for the outfit details. Keep character consistent and place her in a futuristic subway station with cinematic lighting." \
  --image-url https://example.com/char.png \
  --image-url https://example.com/outfit.png \
  --task-type REFERENCE_TO_IMAGE \
  --aspect-ratio 9:16 \
  --resolution 2K

2. `generate_image_nano_banana_pro`

适合：

示例：

python skills/bona-movie-production/scripts/bona_movie_production.py create-image \
  --tool-name generate_image_nano_banana_pro \
  --image-name "premium-reference-kv" \
  --prompt "Refer to the first image for the product shape and the second image for the lighting mood. Create a premium hero shot with clean reflections and luxury beauty campaign quality." \
  --image-url https://example.com/product.png \
  --image-url https://example.com/light.png \
  --task-type REFERENCE_TO_IMAGE \
  --aspect-ratio 1:1 \
  --resolution 4K

四、转视角

这个任务更推荐 `Nano Banana 2`。

原因：

Prompt 写法：

示例 1：单图转侧视角

python skills/bona-movie-production/scripts/bona_movie_production.py create-image \
  --tool-name generate_image_nano_banana_2 \
  --image-name "product-side-view" \
  --prompt "Use the first image as the same product reference. Change the camera view from front view to left side view, while keeping material, color, proportions, and design details unchanged." \
  --image-url https://example.com/product-front.png \
  --task-type REFERENCE_TO_IMAGE \
  --aspect-ratio 1:1 \
  --resolution 2K

示例 2：角色转背视角

python skills/bona-movie-production/scripts/bona_movie_production.py create-image \
  --tool-name generate_image_nano_banana_2 \
  --image-name "character-rear-view" \
  --prompt "Use the first image as the same character reference. Generate a clean rear view of the same character, keeping hairstyle, clothing, silhouette, and proportions consistent." \
  --image-url https://example.com/character-front.png \
  --task-type REFERENCE_TO_IMAGE \
  --aspect-ratio 3:4 \
  --resolution 2K

示例 3：角色三视图

python skills/bona-movie-production/scripts/bona_movie_production.py create-image \
  --tool-name generate_image_nano_banana_2 \
  --image-name "character-turnaround-sheet" \
  --prompt "Use the first image as the same character reference. Create a character turnaround sheet showing front view, side view, and back view, consistent design, clean white background, concept art presentation." \
  --image-url https://example.com/character.png \
  --task-type REFERENCE_TO_IMAGE \
  --aspect-ratio 16:9 \
  --resolution 4K

五、九宫格和 5x5 宫格

这种任务更推荐 `Nano Banana Pro`。

原因：

Prompt 写法：

示例 1：九宫格人物造型板

python skills/bona-movie-production/scripts/bona_movie_production.py create-image \
  --tool-name generate_image_nano_banana_pro \
  --image-name "character-style-board-3x3" \
  --prompt "Create a 3x3 character style board for the same girl in one image, consistent character design, clean editorial layout, white background, fashion mood board quality. Panel 1 full-body front standing pose. Panel 2 full-body left side view. Panel 3 full-body back view. Panel 4 medium shot looking up with arms crossed. Panel 5 medium shot smiling toward camera. Panel 6 medium shot turning while hair moves. Panel 7 close-up calm expression. Panel 8 close-up laughing expression. Panel 9 seated three-quarter view with elegant pose." \
  --task-type TEXT_TO_IMAGE \
  --aspect-ratio 1:1 \
  --resolution 4K

示例 2：九宫格商品展示图

python skills/bona-movie-production/scripts/bona_movie_production.py create-image \
  --tool-name generate_image_nano_banana_pro \
  --image-name "product-grid-3x3" \
  --prompt "Create a 3x3 product grid in one image for the same sneaker, nine clean panels showing different angles and close-up details, premium e-commerce presentation, consistent lighting, white studio background." \
  --task-type TEXT_TO_IMAGE \
  --aspect-ratio 1:1 \
  --resolution 4K

示例 3：5x5 表情宫格

python skills/bona-movie-production/scripts/bona_movie_production.py create-image \
  --tool-name generate_image_nano_banana_pro \
  --image-name "expression-sheet-5x5" \
  --prompt "Create a 5x5 facial expression sheet in one image for the same anime girl, twenty-five panels, consistent character design, each panel with a different expression, clean character sheet layout, white background." \
  --task-type TEXT_TO_IMAGE \
  --aspect-ratio 1:1 \
  --resolution 4K

示例 4：5x5 icon / sticker sheet

python skills/bona-movie-production/scripts/bona_movie_production.py create-image \
  --tool-name generate_image_nano_banana_pro \
  --image-name "sticker-sheet-5x5" \
  --prompt "Create a 5x5 sticker sheet in one image, twenty-five cute food icons, consistent illustration style, balanced spacing, bright clean colors, packaging-ready quality." \
  --task-type TEXT_TO_IMAGE \
  --aspect-ratio 1:1 \
  --resolution 4K

六、文生视频

当用户只有文本描述，没有首帧、尾帧、参考图、参考视频、参考音频时，按文生视频处理。

1. `generate_video_kling_v3`

适合：

参数规则：

Prompt 写法：

示例：

python skills/bona-movie-production/scripts/bona_movie_production.py create-video \
  --tool-name generate_video_kling_v3 \
  --video-name "teaser-shot-01" \
  --prompt "A young woman walking through a rainy neon street at night, reflections on the wet ground, camera slowly tracking forward, blue and pink neon lighting, cinematic atmosphere, realistic motion" \
  --duration 5 \
  --aspect-ratio 16:9 \
  --mode pro \
  --sound on

2. `generate_video_seedance`

适合：

参数规则：

Prompt 写法：

示例：

python skills/bona-movie-production/scripts/bona_movie_production.py create-video \
  --tool-name generate_video_seedance \
  --video-name "character-motion-shot" \
  --prompt "A fashion model turns slowly toward camera, fabric moves naturally, soft cinematic backlight, stable single-shot motion" \
  --duration 6 \
  --aspect-ratio 9:16 \
  --resolution 720P

七、首帧生视频

当用户提供一张起始图片，希望把静态图做成视频时，按首帧生视频处理。

1. `generate_video_kling_v3`

适合：

参数规则：

示例：

python skills/bona-movie-production/scripts/bona_movie_production.py create-video \
  --tool-name generate_video_kling_v3 \
  --video-name "character-i2v" \
  --prompt "The character slowly turns her head, blinks naturally, and breathes subtly. Keep the framing stable and cinematic." \
  --start-frame https://example.com/character-first-frame.png \
  --duration 5 \
  --aspect-ratio 9:16 \
  --mode pro

2. `generate_video_seedance`

适合：

参数规则：

Prompt 写法：

示例：

python skills/bona-movie-production/scripts/bona_movie_production.py create-video \
  --tool-name generate_video_seedance \
  --video-name "seedance-first-frame" \
  --prompt "The subject smiles slightly and the camera pushes in gently, preserving identity and costume details." \
  --start-frame https://example.com/char.png \
  --duration 5 \
  --aspect-ratio 9:16 \
  --resolution 720P

八、首尾帧视频

当用户同时提供起始图和结束图，希望做中间插帧和过渡时，按首尾帧视频处理。

1. `generate_video_kling_v3`

适合：

参数规则：

示例：

python skills/bona-movie-production/scripts/bona_movie_production.py create-video \
  --tool-name generate_video_kling_v3 \
  --video-name "start-end-transition" \
  --prompt "A smooth cinematic transition from the first frame to the final frame, with natural body movement and stable camera motion." \
  --start-frame https://example.com/start.png \
  --end-frame https://example.com/end.png \
  --duration 5 \
  --aspect-ratio 16:9 \
  --mode pro \
  --sound off

2. `generate_video_seedance`

适合：

参数规则：

示例：

python skills/bona-movie-production/scripts/bona_movie_production.py create-video \
  --tool-name generate_video_seedance \
  --video-name "seedance-start-end" \
  --prompt "The character walks from the first pose into the final pose with continuous natural motion and matching costume dynamics." \
  --start-frame https://example.com/start-pose.png \
  --end-frame https://example.com/end-pose.png \
  --duration 6 \
  --aspect-ratio 3:4 \
  --resolution 720P

九、参考图视频

当用户希望人物、产品、IP 形象保持一致性，且提供了一张或多张参考图时，按参考图视频处理。

推荐模型

#### 1. `generate_video_seedance`

适合：

参数规则：

Prompt 写法：

示例：

python skills/bona-movie-production/scripts/bona_movie_production.py create-video \
  --tool-name generate_video_seedance \
  --video-name "reference-image-driven-video" \
  --prompt "Keep the same character identity and create a slow cinematic walk toward camera with subtle wind in hair and coat." \
  --reference-image https://example.com/ref1.png \
  --reference-image https://example.com/ref2.png \
  --reference-image https://example.com/ref3.png \
  --duration 5 \
  --aspect-ratio 16:9 \
  --resolution 720P

十、参考视频视频

当用户提供参考视频，希望做视频风格迁移、动作参考或节奏参考时，按参考视频视频处理。

推荐模型

#### 1. `generate_video_seedance`

适合：

参数规则：

Prompt 写法：

示例：

python skills/bona-movie-production/scripts/bona_movie_production.py create-video \
  --tool-name generate_video_seedance \
  --video-name "reference-video-driven-video" \
  --prompt "Keep the same motion energy as the reference and generate a stylish commercial shot, clean body rhythm, strong fashion lighting." \
  --reference-video https://example.com/motion.mp4 \
  --duration 5 \
  --aspect-ratio 16:9 \
  --resolution 720P

十一、参考音频视频

当用户提供参考音频，希望根据节拍、对白节奏或音乐做视频时，按参考音频视频处理。

推荐模型

#### 1. `generate_video_seedance`

适合：

参数规则：

Prompt 写法：

示例：

python skills/bona-movie-production/scripts/bona_movie_production.py create-video \
  --tool-name generate_video_seedance \
  --video-name "audio-driven-video" \
  --prompt "Generate a stylish dance clip matching the reference beat, strong rhythmic body movement, clean timing accents, energetic stage lighting." \
  --reference-audio https://example.com/beat.mp3 \
  --duration 5 \
  --aspect-ratio 9:16 \
  --resolution 720P

十二、多镜头视频

1. `generate_video_kling_v3`

适合：

参数规则：

Prompt 写法：

schema 示例：

{
  "tool_name": "generate_video_kling_v3",
  "video_name": "multi-shot-trailer",
  "prompt": "Trailer sequence",
  "aspect_ratio": "16:9",
  "duration": 5,
  "mode": "pro",
  "sound": "on",
  "shot_prompts": [
    {
      "index": 0,
      "prompt": "A dark cinema corridor, camera pushes forward, tense ambience",
      "duration": "2"
    },
    {
      "index": 1,
      "prompt": "The heroine turns back suddenly, dramatic backlight, cloth movement",
      "duration": "3"
    }
  ]
}

十三、查询任务

图片查询：

python skills/bona-movie-production/scripts/bona_movie_production.py query-image \
  --task-id your-task-id

视频查询：

python skills/bona-movie-production/scripts/bona_movie_production.py query-video \
  --task-id your-task-id

状态说明：

查询判断规则：

推荐理解方式：

和视频联动时的规则：

十四、实用建议