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