Tuqu Photo Skill 是一个专为与 Tuqu Dream Weaver 图像生成和计费 API 交互而设计的工具，旨在为开发者提供安全、一致且高效的接口调用能力。该技能支持在两个核心主机上运行：`https://photo.tuqu.ai` 负责图像处理与目录管理，而 `https://billing.tuqu.ai/dream-weaver` 则专门处理充值与账单相关操作。其设计重点在于避免常见的认证错误或主机选择失误，确保每次请求都能正确匹配所需的身份验证方式与目标地址。无论是通过脚本还是命令行工具，该技能都强调显式传递凭证的重要性，以防止多角色环境下密钥混淆。此外，它内置了一套清晰的决策流程，帮助用户根据具体需求选择最合适的 API 端点，从而简化复杂工作流的构建过程。
核心功能特点
- 支持双主机架构，分别处理图像生成/目录管理与计费充值流程
- 提供明确的认证模式区分：body userKey、header x-api-key 或 Bearer serviceKey
- 内置请求辅助脚本 tuqu_request.py，自动处理主机选择与鉴权逻辑
- 涵盖从预设应用、提示增强到角色保存的完整图像生成工作流
- 集成余额查询、历史记录查看及微信支付/Stripe 充值功能
- 具备完善的错误处理机制，能直接透传常见 API 异常状态码
适用场景
Tuqu Photo Skill 特别适用于需要稳定调用第三方 AI 图像生成服务的开发场景。例如，在一个内容创作平台中，当用户提交一段模糊的文字描述时，系统可先调用 `/api/enhance-prompt` 对提示词进行优化，再结合参考图片调用 `/api/v2/generate-image` 完成高质量图像输出。若需批量使用特定风格模板（如‘赛博朋克夜景’），则可通过 `/api/catalog` 获取有效 presetId，并配合源图调用 `/api/v2/apply-preset` 实现一键风格迁移。对于多人物互动类内容，该技能支持通过 `/api/characters` 创建持久化角色档案，并在后续生成任务中调用 `/api/v2/generate-for-character` 保持角色一致性。此外，在商业应用中，开发者还可利用其集成支付能力，引导用户通过微信扫码或 Stripe 完成账户充值，同时自动跟踪订单状态与交易流水号，便于后续对账与支持服务。