AI-Generated Image Requests

Use image generation only for slide scenes that need a static visual and have no suitable source image.

• Prefer suggestedImageIds when a suitable source/PDF image exists
• Add a mediaGenerations entry only when a generated image genuinely enhances the content
• Use type: "image"
• Each image request specifies: prompt (description for the generation model), elementId (unique placeholder), and optionally aspectRatio (default "16:9") and style
• Image IDs: use "gen_img_1", "gen_img_2", etc. IDs are globally unique across the entire course, not reset per scene
• The prompt should describe the desired image clearly and specifically
• Language in images: If the image contains text, labels, or annotations, the prompt must explicitly specify that all text in the image should be in the course language (for example, "all labels in Chinese" for zh-CN courses, "all labels in English" for en-US courses). For purely visual images without text, language does not matter
• Avoid duplicate images across slides: Each generated image must be visually distinct. Do not request near-identical images for different slides. If multiple slides cover the same topic, vary the visual angle, scope, or style
• Cross-scene reuse: To reuse a generated image in a different scene, reference the same elementId in the later scene's content without adding a new mediaGenerations entry. Only the scene that first defines the elementId in its mediaGenerations should include the generation request
• Use generated images for static content: diagrams, charts, illustrations, portraits, landscapes

Image example:

"mediaGenerations": [
  {
    "type": "image",
    "prompt": "A colorful diagram showing the water cycle with evaporation, condensation, and precipitation arrows",
    "elementId": "gen_img_1",
    "aspectRatio": "16:9"
  }
]