接入文档

快速开始

灵络AI 提供两套协议:原生接口(推荐)和 OpenAI 兼容接口。两者共用同一个 API Key、同一份积分和线路价格,所有生成都是异步任务: 创建后拿到任务编号,再查询结果。

地址与鉴权

  • 原生接口 Base URL:https://lingluo.vip/openapi
  • OpenAI 兼容 Base URL:https://lingluo.vip/openai/v1
  • 每个请求都要带请求头 Authorization: Bearer <API Key>;不认登录 Cookie。

第 1 步:创建 API Key

登录后打开 API 接入 页面创建 Key。 完整的 Key 只在创建时显示一次,请立即保存;丢失后只能删除重建。每个账号最多 10 个 Key,可以随时停用或删除,立即生效。

Key 等同于账户的消费权限,不要写进前端代码或公开仓库。建议用环境变量保存,例如 LINGLUO_API_KEY。

第 2 步:用测试线路联调

测试线路 channel: "test" 不扣积分、不调用上游模型,创建后立即返回成功和示例结果,适合先把鉴权、创建、查询的流程跑通。 图片模型是 test-image,视频模型是 test-video。

创建测试任务
curl -X POST https://lingluo.vip/openapi/generation/create/image \
  -H "Authorization: Bearer $LINGLUO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "test",
    "model": "test-image",
    "prompt": "联调测试",
    "quality": "1K"
  }'
返回
{
  "code": 0,
  "msg": "ok",
  "data": { "taskId": "test_img_…", "costCredits": 0, "status": 3, "reused": false }
}

第 3 步:正式调用

  1. 调用 GET /generation/config 查看可用的线路(channel)、模型(model)、规格(quality)和价格; 也可以在 API 接入 页的「实时模型映射关系」里直接复制示例。
  2. 调用 POST /generation/create/image 或 /generation/create/video 创建任务,拿到 taskId。创建时按线路价格预扣积分。
  3. 每 10–15 秒调用一次 GET /generation/status?taskId=;status 为 3 时用 GET /generation/detail?taskId= 取结果地址。 失败(status 为 4)的任务积分自动退回。
查询结果
curl "https://lingluo.vip/openapi/generation/detail?taskId=<taskId>" \
  -H "Authorization: Bearer $LINGLUO_API_KEY"

结果文件保留 30 天,到期自动删除,请及时下载转存。完整参数见 原生接口, 计费与错误码见 计费、限制与错误码。

响应格式

原生接口成功时返回 { "code": 0, "msg": "ok", "data": … };失败时 HTTP 状态码照常返回,响应体为{ "code": HTTP 状态码, "msg": 说明, "error": 错误码, "data": 附加信息 },程序请按 error 判断。 OpenAI 兼容接口的错误格式与 OpenAI 一致:{ "error": { "message", "type", "code", "param" } }。