API 错误代码参考#
基础 URL： https://api.ideal.house
版本： v1
更新时间： 2026-03-06
📖 概述#
所有 API 响应均遵循统一的 JSON 结构。发生错误时，code 字段将包含一个非零错误代码，message 字段将提供人类可读的错误描述。
统一响应格式
{
"code": 1001,
"message": "Request failed",
"data": null
}
✅ 成功代码#
示例
{
"code": 0,
"message": "success",
"data": { }
}
❌ 错误代码#
🔧 通用错误#
🔐 认证错误#
🛡️ 内容审核错误#
💰 积分错误#
📋 完整错误代码汇总#
📦 错误响应示例#
1001 — 请求失败#
{
"code": 1001,
"message": "Request failed",
"data": null
}
1003 — 内部服务器错误#
{
"code": 1003,
"message": "Internal server error",
"data": null
}
1011 — 参数错误#
{
"code": 1011,
"message": "Request parameter error: imageUrl is required",
"data": null
}
5002 — API Key无效#
{
"code": 5002,
"message": "Invalid API Key",
"data": null
}
9010 — 文本内容审核失败#
{
"code": 9010,
"message": "Text prompt failed content review, contains prohibited content",
"data": null
}
9038 — 输出包含禁止内容#
{
"code": 9038,
"message": "Prohibited content",
"data": null
}
9051 — 积分不足#
{
"code": 9051,
"message": "Insufficient coins",
"data": null
}
💡 错误处理最佳实践#
- 始终检查
code——不要仅依赖 HTTP 状态码；务必检查响应体中的 code 字段。
- 动态处理
1001——这是一个通用错误代码；message 字段将包含具体原因。
1003 时重试——服务器端错误通常是瞬时的；实现指数退避重试逻辑。- 发送前验证输入——通过在发起 API 调用之前在客户端验证必填字段，避免
1011 错误。
- 内容审核——若收到
9010 或 9038，请在重新提交前对照平台的内容策略审查您的内容。
© Ideal House AI — 保留所有权利。
