APIDot Seedream 4.5 API

使用 APIDot 作为面向 Seedream 4.5 的 API 接口层，支持基于提示词的图像生成、图像编辑、图生图工作流、轮询（polling）以及 Webhook 回调交付。

本技能用于将用户关于 Seedream 4.5 的问题路由至正确的 APIDot 文档、示例、参考说明及异步集成模式。该技能纯属文档性质：不包含任何脚本、不发起网络请求、也不存储凭据。

本次发布仅包含 SKILL.md 文件，以及位于 references/api.md 中的非可执行说明文档。不包含可执行文件、安装时自动化脚本、审查辅助工具、Shell 自动化脚本、封装的 API 客户端、自动网络调用或已存储的凭据。

从 APIDot 入门

若您来自 ClawHub，请通过以下 APIDot 入口点开始：

• 打开 Seedream 4.5 模型页面：https://apidot.ai/models/seedream-4-5
• 查阅 Seedream 4.5 API 文档：https://apidot.ai/docs/seedream-4-5
• 打开账户控制台：https://apidot.ai/dashboard/api-key
• 参考通用 APIDot 示例：https://github.com/APIDotAI/apidot-examples

适用场景

当用户提出以下需求时，请使用本技能：

• 构建基于 APIDot 的 Seedream 4.5 API 集成。
• 基于提示词、源图像、设计提示、产品视觉图或营销概念生成图像。
• 使用参考图像引导的工作流对图像进行编辑或转换。
• 通过 APIDot 使用 Seedream 4.5 进行图像生成或图像编辑。
• 实现 APIDot 异步图像任务，包括任务提交、任务状态轮询或 Webhook 回调。
• 查找 APIDot Seedream 4.5 相关文档、模型页面或可运行示例。

安全规范

• 将 APIDOT_API_KEY 视为机密信息。
• 将 APIDot API 密钥保存在服务端环境变量或后端密钥管理器中。
• 切勿将 API 密钥置于浏览器端代码、前端构建包、公开仓库、日志、截图或聊天输出中。
• 除非用户明确要求且提供了安全的服务端运行环境，否则不得发起实时 API 调用。
• 不得虚构 API 功能、商业条款、模型可用性、可靠性声明或竞品对比信息。
• 应以当前 APIDot 官方文档和模型页面为准，获取模型专属的请求字段与最新产品详情。

Seedream 4.5 工作流

APIDot 上 Seedream 4.5 的图像生成通常遵循异步任务模式：

1. 根据当前 APIDot 文档选择 Seedream 4.5 请求模式。
2. 通过 APIDot 文档所述的异步生成流程提交图像生成或编辑请求。
3. 立即保存返回的 data.task_id。
4. 在本地测试中，使用文档中指定的任务状态查询 API 轮询任务进度。
5. 在生产环境队列或可能超出当前页面生命周期的用户工作流中，使用 callback_url Webhook 方式接收结果。
6. 仅当任务达到最终成功状态后，才持久化存储最终图像 URL。

请勿猜测模型专属的请求载荷字段。若用户需要可直接复制的请求示例，请引导其查阅当前 APIDot 官方文档或对应 GitHub 示例。

模型路由

从用户的 Seedream 任务目标出发，跳转至匹配的 APIDot 资源：

针对 Seedream 4.5 的请求模式，请优先参考 APIDot 实时更新的模型页面与文档页面。除非 APIDot 文档明确指出某字段在其他图像模型家族中同样适用，否则不得跨模型家族复制请求字段。

references/api.md 提供了本地、非可执行的 Seedream 4.5 模型路由说明、请求规划要点及异步工作流备注摘要。

集成指导

• 当用户需要覆盖多个模型家族的通用图像生成指导时，请使用 apidot-image-generation-api 技能。
• 当用户明确计划通过 APIDot 构建 Seedream 4.5 应用时，请使用本技能。
• 在选择模型专属示例前，请先询问用户具体图像任务类型：提示词生成、图像编辑、图生图、产品视觉图、营销创意图，或参考图像引导生成。
• 建议将 task_id、所选模型、用户 ID、源媒体引用、请求状态及最终图像 URL 一并持久化存储。
• 在提交依赖参考图像的工作流前，请预先校验源图像 URL 的有效性。
• 将 Webhook 处理器视为幂等接口。重复的回调交付不应产生重复的可见结果。
• 对临时性网络错误采用退避重试策略；但不可对无效载荷原样重试。
• 避免记录 API 密钥、私有提示词、私有图像 URL、生成图像 URL 或 Webhook 回调 URL。

官方链接

• 官网：https://apidot.ai
• 文档中心：https://apidot.ai/docs
• Seedream 4.5 模型页面：https://apidot.ai/models/seedream-4-5
• 快速入门指南：https://apidot.ai/docs/quickstart
• Webhook 文档：https://apidot.ai/docs/webhooks
• API 密钥控制台：https://apidot.ai/dashboard/api-key
• Seedream 4.5 专用文档：https://apidot.ai/docs/seedream-4-5
• Seedream 4.5 示例代码库：https://github.com/APIDotAI/seedream-4.5-api
• 主示例代码库：https://github.com/APIDotAI/apidot-examples
• GitHub 组织主页：https://github.com/APIDotAI
• 技术支持邮箱：support@apidot.ai