使用指南
- 使用此接口检查封面生成任务的状态
- 处理完成后访问生成的封面图片URL
- 跟踪处理进度和可能发生的任何错误
- 支持轮询方式获取任务结果,建议每30秒查询一次
开发者注意事项
- 封面图片URL仅在成功完成时可用
- 对于失败的任务提供错误代码和消息
- 成功处理后,封面图片保留14天
- 通常会生成2张不同风格的封面图片
Authorizations
所有接口都需要通过 Bearer Token 方式进行认证。
获取 API Key:
- 访问 API Key 管理页面 获取您的 API Key
使用方式: 在请求头中添加: Authorization: Bearer YOUR_API_KEY
注意事项:
- 请妥善保管您的 API Key,不要泄露给他人
- 如果怀疑 API Key 泄露,请立即在管理页面重置
Query Parameters
要获取的Cover生成任务的唯一标识符。这是创建Cover生成任务时返回的taskId。
Response
成功
状态码 响应状态码
- 200: 成功 - 请求已成功处理
- 400: 格式错误 - 参数不是有效的JSON格式
- 401: 未授权 - 身份验证凭据缺失或无效
- 402: 积分不足 - 账户没有足够的积分执行此操作
- 404: 未找到 - 请求的资源或端点不存在
- 409: 冲突 - Cover记录已存在
- 422: 验证错误 - 请求参数未通过验证检查
- 429: 超出限制 - 已超过对此资源的请求限制
- 455: 服务不可用 - 系统当前正在进行维护
- 500: 服务器错误 - 处理请求时发生意外错误
Available options:
200
, 400
, 401
, 402
, 404
, 409
, 422
, 429
, 455
, 500
Example:
200
状态信息 当 code != 200 时的错误信息
Example:
"success"