用途：通过 Python 脚本 scripts/generate.py 调用 Google Gemini Lyria 3 生成音乐文件，脚本会根据请求/purpose 自动选择模型：Lyria 3 Pro（lyria-3-pro-preview）用于完整歌曲、含 verse/chorus/bridge 与歌词、录音室级输出；Lyria 3 Clip（lyria-3-clip-preview）用于30秒片段、循环、jingle、音效标识和快速试听迭代。自动选 Pro 的条件（满足任一）：指定 --pro；提示词含完整歌曲关键词（如歌詞、フル尺、楽曲、full-length、verse、chorus、lyrics、professional）；提示词长度 100 字符以上。选 Clip 的条件：指定 --clip；提示词含片段关键词（如ループ、ジングル、30秒、clip、loop、jingle、preview）；不满足任何 Pro 条件时默认 Clip。建议先用 --clip 快速迭代提示词，再用 --pro 生成完整曲目。
前置条件：安装依赖 pip install google-genai。配置凭据二选一：Gemini Developer API 设置 GEMINI_API_KEY 环境变量（密钥获取见 https://aistudio.google.com/apikey）；Vertex AI 设置 GOOGLE_CLOUD_PROJECT，可选 GOOGLE_CLOUD_LOCATION，需启用 Vertex AI API 的 GCP 项目并配置应用默认凭据。两者同时设置时优先使用 Vertex AI。可选环境变量：LYRIA_MODEL 强制指定模型；AUDIO_OUTPUT_DIR 默认输出目录（./lyria-music）；LYRIA_NO_SSL_VERIFY 设为 1/true/yes 可禁用 SSL 证书校验。
用法示例：python scripts/generate.py "lofi hip hop, mellow piano, rainy night, relaxed beat"；强制片段加 --clip -o jingle.mp3；强制完整歌曲用 --pro 并可在提示词中使用 [Verse]/[Chorus] 结构标签；Pro 可加 --wav 输出 WAV（Clip 仅输出 MP3）；--json 供程序化使用；--no-ssl-verify 在代理或自签名证书环境使用。--pro 与 --clip 互斥。输出为 48 kHz 立体声，Clip 固定约30秒，Pro 为完整歌曲（约几分钟），扩展名由 API 返回的音频 MIME 类型推导。
提示词建议：组合风格、情绪、乐器编排、速度节奏、人声（Pro）与歌曲结构（Pro 用段落标签，也可加如 [0:00 - 0:10] 的时间戳）；提示词语言决定演唱语言。更完整的提示参考见 references/prompts.md。
限制：单轮调用，各次相互独立，不能对已生成曲目做多轮编辑；不支持真实艺术家声音克隆，相关提示会被安全过滤拦截；不支持负面提示词或 seed；安全过滤拦截内容时需改写提示词，达到速率限制需等待重试，未返回音频时应让提示词更具体。