开放 API 和 API Key 使用说明

开放 API 适合开发者把 Piccc AI 的对话、图片生成和视频生成能力接入自己的应用、自动化脚本或业务系统。

API 能做什么

能力	说明
对话模型	可接入内容生成、改写、摘要、分类等场景
图片任务	提交图片生成任务，并轮询查询结果
视频任务	提交视频生成任务，并查询状态
WebHook	任务完成后接收回调通知

使用前需要准备什么

登录 Piccc AI。
确认账号支持开放 API。
在开放 API 页面进入“ApiKey”。
创建 API Key。
把密钥保存到服务端环境变量，不要放到前端代码里。

线上页面提示：开放 API 仅高级会员及以上可用。实际权限以页面展示为准。

API Key 安全建议

建议	原因
不要发给别人	拿到密钥就可能调用你的额度
不要提交到公开仓库	公开后很容易被滥用
不要写在前端代码里	用户可以在浏览器里看到
发现泄露立即删除或重建	防止继续产生消耗

调用方式

开放 API 支持常见 SDK 接入方式。对话接口通常可以参考 OpenAI 或 Anthropic 兼容调用方式，只需调整 base URL、模型名和 API Key。

图片和视频任务通常是异步流程：

提交任务。
获得任务 ID。
轮询任务状态，或等待 WebHook 回调。
获取结果链接或失败原因。

遇到 API 问题时提供什么

联系支持时，请提供：

信息	说明
请求时间	大概什么时候调用
接口名称	对话、图片任务、视频任务或任务查询
任务 ID	如果已经返回任务 ID
错误信息	HTTP 状态码和错误提示
账号信息	绑定手机号或邮箱

请不要发送完整 API Key、完整 token 或其他敏感凭据。