# 影墨·今颜代码实例：Python调用API生成带朱砂印章水印的人像图 ## 1. 环境准备与快速部署 在开始使用影墨·今颜生成带朱砂印章水印的人像图之前，我们需要先准备好Python环境并安装必要的依赖包。 ### 1.1 安装必要的Python库 首先确保你的Python版本在3.8以上，然后通过pip安装以下依赖： ```bash pip install requests pillow python-dotenv ``` 这些库的作用分别是： - `requests`：用于发送HTTP请求调用API - `pillow`：Python图像处理库，用于处理生成的图片 - `python-dotenv`：用于管理环境变量和API密钥 ### 1.2 获取API访问凭证 要使用影墨·今颜的API服务，你需要先获取API密钥。通常可以在官方平台注册账号后，在开发者中心创建API密钥。 创建一个`.env`文件来安全存储你的API密钥： ```ini YMJY_API_KEY=你的API密钥 YMJY_API_URL=https://api.yingmojinyan.com/v1/generate ``` ## 2. 基础概念快速入门 影墨·今颜是一个基于FLUX.1生成引擎的AI影像系统，专门生成具有电影质感和东方韵味的人像图片。理解几个核心概念能帮助你更好地使用这个系统。 ### 2.1 什么是提示词(Prompt) 提示词就是你用文字描述想要生成的图片内容。比如："一位穿着汉服的女子在樱花树下，阳光透过树叶洒在脸上，表情温柔微笑"。 **写好提示词的技巧**： - 使用英文描述（效果更好） - 包含主体、场景、光影、情绪等要素 - 避免过于复杂或矛盾的描述 ### 2.2 神韵强度(Scale)的作用 神韵强度控制着生成图片的风格化程度： - 较低值：更接近你的文字描述 - 较高值：更强调影墨·今颜特有的美学风格 ### 2.3 图片比例选择 系统支持三种比例： - 竖版 (9:16) - 适合小红书等社交平台 - 方版 (1:1) - 通用比例 - 横版 (16:9) - 适合宽屏展示 ## 3. Python调用API生成人像 现在我们来编写实际的Python代码，通过API生成带朱砂印章水印的人像图片。 ### 3.1 基础API调用代码 首先创建一个Python文件，比如`yingmo_generate.py`： ```python import requests import json from PIL import Image import io import os from dotenv import load_dotenv # 加载环境变量 load_dotenv() class YingMoGenerator: def __init__(self): self.api_key = os.getenv('YMJY_API_KEY') self.api_url = os.getenv('YMJY_API_URL') self.headers = { 'Authorization': f'Bearer {self.api_key}', 'Content-Type': 'application/json' } def generate_image(self, prompt, scale=7.5, ratio="9:16", save_path="output.png"): """ 生成带朱砂印章水印的人像图片 参数: prompt: 英文描述文本 scale: 神韵强度 (5.0-10.0) ratio: 图片比例 ("9:16", "1:1", "16:9") save_path: 图片保存路径 """ # 构建请求数据 payload = { "prompt": prompt, "scale": scale, "ratio": ratio, "include_watermark": True # 包含朱砂印章水印 } try: # 发送API请求 response = requests.post( self.api_url, headers=self.headers, data=json.dumps(payload) ) # 检查响应状态 if response.status_code == 200: # 从响应中获取图片数据 image_data = response.content # 保存图片 with open(save_path, 'wb') as f: f.write(image_data) print(f"图片已生成并保存到: {save_path}") return save_path else: print(f"API请求失败: {response.status_code}") print(response.text) return None except Exception as e: print(f"生成过程中出现错误: {str(e)}") return None # 使用示例 if __name__ == "__main__": generator = YingMoGenerator() # 示例提示词 - 描述想要生成的画面 prompt = "A beautiful Chinese woman in traditional Hanfu, standing under cherry blossom trees, soft sunlight, cinematic lighting, photorealistic, extremely detailed skin texture" # 生成图片 result = generator.generate_image( prompt=prompt, scale=7.5, ratio="9:16", save_path="hanfu_beauty.png" ) ``` ### 3.2 批量生成多张图片 如果你需要批量生成多张不同风格的人像，可以使用以下代码： ```python def batch_generate_images(self, prompts_list, output_dir="output_images"): """ 批量生成多张图片 参数: prompts_list: 包含多个提示词和设置的列表 output_dir: 输出目录 """ # 创建输出目录 if not os.path.exists(output_dir): os.makedirs(output_dir) results = [] for i, prompt_config in enumerate(prompts_list): prompt = prompt_config.get("prompt") scale = prompt_config.get("scale", 7.5) ratio = prompt_config.get("ratio", "9:16") # 生成文件名 filename = f"image_{i+1}.png" save_path = os.path.join(output_dir, filename) print(f"正在生成第 {i+1} 张图片...") result = self.generate_image(prompt, scale, ratio, save_path) if result: results.append(result) return results # 使用示例 prompts_to_generate = [ { "prompt": "Elegant woman in qipao, Shanghai 1920s style, vintage film grain, soft lighting", "scale": 8.0, "ratio": "1:1" }, { "prompt": "Modern Chinese fashion model, urban background, golden hour lighting, high fashion photography", "scale": 7.0, "ratio": "9:16" }, { "prompt": "Traditional Chinese dancer, flowing silk dress, dynamic movement, studio lighting", "scale": 7.5, "ratio": "16:9" } ] generator = YingMoGenerator() generator.batch_generate_images(prompts_to_generate) ``` ## 4. 高级功能与实用技巧 ### 4.1 自定义朱砂印章样式 虽然API默认会添加朱砂印章水印，但你也可以通过参数微印章的样式： ```python def generate_with_custom_watermark(self, prompt, watermark_style="classic", watermark_position="bottom_right", **kwargs): """ 生成带自定义朱砂印章水印的图片 参数: watermark_style: 印章样式 ("classic", "minimal", "artistic") watermark_position: 印章位置 ("bottom_right", "bottom_left", "top_right", "top_left") """ payload = { "prompt": prompt, "watermark_style": watermark_style, "watermark_position": watermark_position, **kwargs } # 其余代码与基础生成函数类似 # ... ``` ### 4.2 图片后处理与优化 生成图片后，你可能还需要进行一些后处理： ```python from PIL import Image, ImageEnhance def enhance_image(image_path, output_path=None, brightness=1.0, contrast=1.0, sharpness=1.0): """ 对生成的图片进行后处理优化 参数: image_path: 原始图片路径 output_path: 输出路径（如为None则覆盖原图） brightness: 亮度调整 (0.0-2.0) contrast: 对比度调整 (0.0-2.0) sharpness: 锐度调整 (0.0-2.0) """ if output_path is None: output_path = image_path with Image.open(image_path) as img: # 调整亮度 if brightness != 1.0: enhancer = ImageEnhance.Brightness(img) img = enhancer.enhance(brightness) # 调整对比度 if contrast != 1.0: enhancer = ImageEnhance.Contrast(img) img = enhancer.enhance(contrast) # 调整锐度 if sharpness != 1.0: enhancer = ImageEnhance.Sharpness(img) img = enhancer.enhance(sharpness) # 保存图片 img.save(output_path) print(f"图片已优化并保存到: {output_path}") return output_path # 使用示例 enhance_image("hanfu_beauty.png", "enhanced_hanfu.png", brightness=1.1, contrast=1.05, sharpness=1.2) ``` ## 5. 常见问题与解决方案 ### 5.1 API调用失败排查 如果API调用失败，可以按照以下步骤排查： ```python def debug_api_issue(self): """API问题调试工具""" # 检查API密钥 if not self.api_key or self.api_key == "你的API密钥": print("错误: 请检查API密钥是否正确配置") return False # 测试连接 try: test_response = requests.get( self.api_url.replace('/generate', '/health'), headers={'Authorization': f'Bearer {self.api_key}'}, timeout=10 ) print(f"API健康状态: {test_response.status_code}") return test_response.status_code == 200 except Exception as e: print(f"连接测试失败: {str(e)}") return False ``` ### 5.2 图片质量优化建议 如果生成的图片质量不理想，可以尝试以下方法： 1. **优化提示词**：添加更多细节描述，如"extremely detailed", "photorealistic", "8k resolution" 2. **调整神韵强度**：尝试不同的scale值（5.0-10.0） 3. **使用负面提示**：添加不想要的内容，如"blurry", "deformed", "bad anatomy" ```python def generate_with_negative_prompt(self, prompt, negative_prompt, **kwargs): """ 使用负面提示词生成图片 参数: negative_prompt: 不希望出现在图片中的内容 """ payload = { "prompt": prompt, "negative_prompt": negative_prompt, **kwargs } # 发送请求的代码... ``` ## 6. 总结 通过本文的Python代码实例，你已经学会了如何使用影墨·今颜API生成带朱砂印章水印的高质量人像图片。关键要点包括： 1. **环境配置**：正确安装依赖库和配置API密钥 2. **基础调用**：使用简单的Python函数调用生成API 3. **批量处理**：如何一次性生成多张不同风格的图片 4. **高级功能**：自定义水印样式和图片后处理技巧 5. **问题排查**：常见问题的解决方法 影墨·今颜的强大之处在于它能够生成极具东方美学特色和电影质感的人像图片，而朱砂印章水印更是为其增添了独特的文化韵味。无论是用于个人创作、商业设计还是社交媒体内容，这个工具都能帮助你快速生成专业级的人像作品。 现在你可以开始尝试不同的提示词和参数组合，探索影墨·今颜的各种创作可能性，生成属于你自己的独特人像作品。 --- > **获取更多AI镜像** > > 想探索更多AI镜像和应用场景？访问 [CSDN星图镜像广场](https://ai.csdn.net/?utm_source=mirror_blog_end)，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。