了解如何配置 API Key、选择模型，以及使用各项生成功能
Clipora 是一个 AI 驱动的图像与视频创作平台，基于 Google Gemini 和 Veo 系列模型。 无论你是创意工作者、内容创作者还是开发者，都可以通过简单的操作生成高质量内容。
输入文字描述，秒级生成高质量图片，支持多种风格和宽高比
基于图片或文字提示，生成 4-8 秒流畅视频，动作自然生动
创建专属角色，在不同生成任务中保持角色外观一致性
三步开始创作
平台 Provider vs 自定义 Provider
| 特性 | 平台 Provider | 自定义 Provider |
|---|---|---|
| 适用套餐 | 所有用户 | Pro / Enterprise |
| 无需配置 | ✓ | ✗ |
| 使用自有配额 | ✗ | ✓ |
| 自定义模型 | ✗ | ✓ |
| 最高并发 | 受限 | 取决于你的 Key |
配置步骤
进入 API 配置页面
在左侧导航栏点击「API 配置」，或直接访问 /api-config 路径。
添加 Provider
点击页面右上角的「添加 Provider」按钮，打开配置向导。
填写配置信息
输入配置名称、API Key 和 Base URL（选填）。
测试连接
点击「测试连接」按钮，系统将验证 Key 的有效性并自动加载可用模型列表。
选择模型
从加载的模型列表中，分别选择用于图像生成和视频生成的模型。
保存配置
确认配置信息无误后，点击「保存」完成配置。配置立即生效。
配置示例
配置名称：我的 Gemini API
API Key：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Base URL：https://yunwu.ai/v1 （留空则使用默认 Google 端点）配置自定义 Provider 后，系统会自动从你的 API 端点拉取可用模型列表， 并按用途分类为图像生成模型和视频生成模型。
gemini-2.5-flash-image推荐Google Gemini 最新图像生成模型，速度快、质量高，支持多种风格
gemini-2.0-flash-exp实验性模型，支持更复杂的图像理解与创作任务
veo-3.1-generate-preview推荐Google Veo 视频生成旗舰模型，支持高清视频生成，动作流畅自然
veo-2.0-generate-001稳定版视频生成模型，适合批量处理场景
进入「工作台 → 图片生成」即可开始创作。支持文字生图、关联角色、设置宽高比等功能。
参数说明
描述你想要生成的图片内容，越详细效果越好。支持中英文。
描述不希望在图片中出现的元素，例如「模糊、低质量、变形」。
从角色库中选择已创建的角色，保持生成内容的人物一致性。
支持 1:1（正方形）、16:9（横屏）、9:16（竖屏）、4:3、3:4 等比例。
提示词技巧
✅ 具体描述主体
示例：一位穿红色旗袍的年轻女性，站在上海外滩
✅ 指定风格/质感
示例：电影感、油画风格、8K 超清
✅ 描述光线环境
示例：黄昏、逆光、柔和自然光
❌ 避免过于抽象
示例：好看的图片、完美的场景
进入「工作台 → 视频生成」，支持「图片转视频」和「文字转视频」两种模式。
图片转视频 (I2V)
文字转视频 (T2V)
视频提示词建议
每个套餐包含固定的月度配额，超出配额后自动切换到余额扣费模式。
| 套餐 | 图片/月 | 视频/月 | 角色/月 | 自定义 API |
|---|---|---|---|---|
| Free | 10 | 2 | 3 | — |
| Basic | 100 | 20 | 10 | — |
| Pro | 500 | 100 | 50 | |
| Enterprise | 不限 | 不限 | 不限 |
配额消耗优先级
API Key 存储在哪里？安全吗？
API Key 经过加密后存储在我们的数据库中，传输过程使用 HTTPS 加密，前端不会明文展示完整 Key。我们遵循业界最佳安全实践，请放心使用。
平台自带 API 还是需要自己提供？
平台为所有用户提供内置的平台级 Provider，无需自备 API Key 即可使用。Pro 和 Enterprise 用户可以额外配置自己的 API Key，使用自有配额，享有更高的并发和优先级。
测试连接失败怎么办？
请检查：1) API Key 是否正确，格式通常为 sk- 开头；2) Base URL 是否填写正确（若使用默认地址可留空）；3) API Key 是否已过期或余额不足；4) 网络是否可以正常访问 API 端点。
配额用完后会怎样？
订阅配额用完后，系统会自动切换到余额扣费模式。如果余额也不足，生成请求将被拒绝，并提示你充值或升级套餐。
如何切换使用不同的 Provider？
在「API 配置」页面，点击已保存的 Provider 卡片上的「设为默认」按钮，即可将其设置为当前使用的 Provider。系统将优先使用默认 Provider 进行生成。
可以同时配置多个 Provider 吗？
可以。Pro/Enterprise 用户可以配置多个 Provider，每个 Provider 可以配置不同的模型组合。通过「设为默认」来指定当前使用哪个 Provider。
还有其他问题？
欢迎通过平台内的「AI 助理」功能获取帮助，或联系我们的支持团队。