LinkfoxAI API 对接文档：快速接入、鉴权与调用示例

准备好 API Key 和图片后，选择作图功能提交任务，再用任务 ID 查询并下载结果。

接入信息

API 调用地址https://ai-api.linkfox.com

以下两种请求头方式任选一种：

Header

Authorization: Bearer <API Key>
Content-Type: application/json

直接填写以 http:// 或 https:// 开头、可公开访问且加载稳定的图片地址。

先调用图片上传获得图片地址，再把返回地址填写到作图接口的 imageUrl 或 imageList。

保存任务 ID

作图接口受理后会返回 data.id，后续查询必须使用这个任务 ID。

查询执行状态

调用获取作图结果，建议每次查询至少间隔 10 秒，直到任务成功或失败。

及时保存图片

结果图片地址有效期为 8 小时。请及时下载；地址过期后调用刷新结果图片地址。

提交成功后，接口会返回下面这样的信息。data.id 是本次任务的编号，请按字符串保存，之后用它查询生成结果。code 为 200 只表示任务已创建，图片或视频还需要等待生成。

JSON

{
  "code": 200,
  "msg": "成功",
  "traceId": "f6e0fe4f360f78445c2c5d52f2414dea",
  "data": { "id": "1930923414987821056" }
}

错误码	含义	处理建议
ERR_FILED_VALIDATE	请求参数不符合要求	检查必填字段、字段类型和可选值
ERR_VALIDATE_FAIL	请求参数校验未通过	对照当前功能的请求体说明检查参数
ERR_IMAGE_MAKE_AUDIT	图片或内容未通过审核	调整图片或提示词后重新提交
ERR_IMAGE_MAKE_WILL_OUT	可用点数不足	前往查询当前套餐确认剩余点数
ERR_FORBIDDEN	当前团队无权访问该任务 ID	确认任务 ID 来自当前 API Key 所属团队
ERR_NOT_HAVE_TEAM_PRIVILEGE	账号未绑定团队	先完成团队绑定和 API 权限配置
TEAM_PERMISSION_DISABLE_USER	账号已被禁用	联系团队管理员检查账号状态
TEAM_PERMISSION_EXPIRE	套餐已过期或尚未购买	检查当前套餐状态后再调用