接入文档
快速开始
灵络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 步:正式调用
- 调用
GET /generation/config查看可用的线路(channel)、模型(model)、规格(quality)和价格; 也可以在 API 接入 页的「实时模型映射关系」里直接复制示例。 - 调用
POST /generation/create/image或/generation/create/video创建任务,拿到taskId。创建时按线路价格预扣积分。 - 每 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"
响应格式
原生接口成功时返回 { "code": 0, "msg": "ok", "data": … };失败时 HTTP 状态码照常返回,响应体为{ "code": HTTP 状态码, "msg": 说明, "error": 错误码, "data": 附加信息 },程序请按 error 判断。 OpenAI 兼容接口的错误格式与 OpenAI 一致:{ "error": { "message", "type", "code", "param" } }。