接入文档

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 的标准字段外,可以用扩展字段指定规格等参数:

创建任务参数
字段类型必填说明
modelstring是线路编号:模型名
promptstring是提示词
secondsstring | number否视频时长(秒),不传取该模型的第一个可选时长
sizestring否如 1280x720,自动换算成最接近的可选比例;也可以直接写 16:9
input_referencefile | string否参考素材:multipart 文件,或公网地址;文件按类型归为参考图、参考视频或参考音频
qualitystring否扩展:规格档,不传取默认规格
aspect_ratiostring否扩展:比例,优先于 size
nnumber否扩展:图片张数
input_images / input_videos / input_audiosstring[]否扩展:参考素材地址列表
expected_creditsnumber否扩展:预期扣费,与当前价格不一致返回 price_changed
curl
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"
  }'
Python(openai SDK)
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)
返回(video 对象)
{
  "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