LogoLogoAPI 文档
LogoLogoAPI 文档
首页
概览鉴权与幂等图片生成图片编辑图片转换任务与有限等待积分错误速率与并发限制API 更新日志
API 文档

错误

稳定的错误包装、错误码和 HTTP 状态

错误使用固定包装,绝不会包含私有诊断信息:

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "The request is invalid.",
    "request_id": "req_012345"
  }
}
HTTP错误码含义
400INVALID_REQUEST请求体、表单字段、请求头或图片无效
400CONTENT_POLICY_VIOLATION请求无法处理
401UNAUTHORIZEDAPI 密钥缺失或无效
402INSUFFICIENT_CREDITS可用积分不足
403FORBIDDEN缺少所需权限或测试资格
404JOB_NOT_FOUND任务不存在或属于其他账户
409IDEMPOTENCY_CONFLICT同一幂等键对应不同内容
409JOB_CANCELED任务已取消
429RATE_LIMIT_EXCEEDED超过请求限制
500JOB_FAILED图片任务未能完成
500INTERNAL_ERROR请求未能完成

上传大小超限使用 HTTP 413,错误码仍为 INVALID_REQUEST。429 和非终态任务可按 文档延迟重试。其他错误应修改请求,或携带 request_id 联系支持;程序逻辑不要依赖 人类可读的 message。

积分

查询余额并理解预留机制

速率与并发限制

按密钥统计的请求限制和账户任务限制