接入文档
OpenAI 兼容接口
Base URL https://lingluo.vip/openai/v1。已经在用 OpenAI SDK 的项目改 Base URL 和 Key 即可。图片和视频都走视频接口 /videos, 按线路的类型区分;计费、幂等、限流与原生接口完全一致。
模型 ID
模型 ID 的格式是 线路编号:模型名,例如 86:gpt-image-2。线路编号决定价格和货源,同一个模型在不同线路上价格可能不同。 测试线路是 test:test-image 和 test:test-video。
GET/models
返回 { object: "list", data: [{ id, object: "model", owned_by, metadata }] }。metadata 里带类型(image / video)、线路名称、规格与原价、比例、时长和会员折扣。
curl https://lingluo.vip/openai/v1/models \ -H "Authorization: Bearer $LINGLUO_API_KEY"
创建任务
POST/videos
支持 JSON 和 multipart(OpenAI SDK 默认用 multipart)。除 OpenAI 的标准字段外,可以用扩展字段指定规格等参数:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 线路编号:模型名 |
| prompt | string | 是 | 提示词 |
| seconds | string | number | 否 | 视频时长(秒),不传取该模型的第一个可选时长 |
| size | string | 否 | 如 1280x720,自动换算成最接近的可选比例;也可以直接写 16:9 |
| input_reference | file | string | 否 | 参考素材:multipart 文件,或公网地址;文件按类型归为参考图、参考视频或参考音频 |
| quality | string | 否 | 扩展:规格档,不传取默认规格 |
| aspect_ratio | string | 否 | 扩展:比例,优先于 size |
| n | number | 否 | 扩展:图片张数 |
| input_images / input_videos / input_audios | string[] | 否 | 扩展:参考素材地址列表 |
| expected_credits | number | 否 | 扩展:预期扣费,与当前价格不一致返回 price_changed |
curl -X POST https://lingluo.vip/openai/v1/videos \
-H "Authorization: Bearer $LINGLUO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "60:kling-v2",
"prompt": "镜头缓慢推进,海浪拍打礁石",
"seconds": "5",
"size": "1280x720"
}'import os
from openai import OpenAI
client = OpenAI(base_url="https://lingluo.vip/openai/v1", api_key=os.environ["LINGLUO_API_KEY"])
video = client.videos.create(
model="60:kling-v2",
prompt="镜头缓慢推进,海浪拍打礁石",
seconds="5",
extra_body={"quality": "720p"}, # 扩展字段用 extra_body 传
)
print(video.id, video.status){
"id": "01M7ABD5K8M0EYY06VSA5QW2R1",
"object": "video",
"model": "60:kling-v2",
"status": "queued",
"progress": 0,
"created_at": 1794569000,
"completed_at": null,
"error": null,
"metadata": {
"type": "video",
"result_url": null,
"result_urls": [],
"cost_credits": 200
}
}图片任务同样返回
object: "video",用 metadata.type 区分。请求头 Idempotency-Key 的用法与原生接口相同。查询与下载
GET/videos/{id}
返回同样的 video 对象。状态为 queued、in_progress、completed、failed;完成后结果地址在metadata.result_url(多张图片见 metadata.result_urls),失败原因在 error。
GET/videos/{id}/content
完成后 302 跳转到结果文件;未完成返回 409,结果已过保留期返回 404。
curl -L https://lingluo.vip/openai/v1/videos/<id>/content \ -H "Authorization: Bearer $LINGLUO_API_KEY" \ -o result.mp4