灵动中转站 API 文档

快速接入

灵动中转站完全兼容 OpenAI SDK，只需将 base_url 改为 https://lingdongapi.com/v1，并替换为您的 API Key 即可。

Python

# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxxxxxxxxxxxxxxxxxx",
    base_url="https://lingdongapi.com/v1"
)

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "你好！"}]
)
print(response.choices[0].message.content)

Node.js

// npm install openai
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-xxxxxxxxxxxxxxxxxxxxxxxx',
  baseURL: 'https://lingdongapi.com/v1',
});

const res = await client.chat.completions.create({
  model: 'gpt-5.4',
  messages: [{ role: 'user', content: '你好！' }],
});
console.log(res.choices[0].message.content);

curl

curl https://lingdongapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "你好！"}]
  }'

鉴权方式

所有请求需在 HTTP Header 中携带 API Key：

Authorization: Bearer YOUR_API_KEY

对话补全

{
  "model": "claude-sonnet-4-6",
  "messages": [
    {"role": "system", "content": "你是一个有帮助的助手。"},
    {"role": "user", "content": "用 Python 写一个快速排序算法"}
  ],
  "temperature": 0.7,
  "stream": false
}

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1715000000,
  "model": "claude-sonnet-4-6",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "def quick_sort(arr):\n    ..."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 156,
    "total_tokens": 184
  }
}

# Python 流式示例
stream = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "讲个故事"}],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

图像生成

{
  "model": "gpt-image-2",
  "prompt": "一只在星空下奔跑的白色独角兽，梦幻风格，高清",
  "n": 1,
  "size": "1024x1024"
}

response = client.images.generate(
    model="gpt-image-2",
    prompt="一只在星空下奔跑的白色独角兽",
    n=1,
    size="1024x1024"
)
print(response.data[0].url)

视频生成

curl https://lingdongapi.com/v1/videos/generations \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "一只小猫站在雨夜霓虹街头，电影感镜头推进",
    "duration": 8,
    "orientation": "portrait",
    "watermark": false
  }'

curl https://lingdongapi.com/v1/videos/generations \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3",
    "prompt": "镜头缓缓拉远，展现城市全景",
    "duration": 5,
    "orientation": "landscape",
    "images": ["https://example.com/reference.jpg"]
  }'

curl https://lingdongapi.com/v1/videos/generations \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd-2",
    "prompt": "@图片1 的风格，配合@视频2 的动作，生成一段流畅的转场动画",
    "duration": 8,
    "orientation": "landscape",
    "images": ["https://example.com/style.jpg"],
    "videos": ["https://example.com/motion.mp4"]
  }'

{
  "code": "success",
  "data": {
    "task_id": "task_abc123xyz",
    "status": "NOT_START",
    "progress": "0%"
  }
}

查询视频任务状态

curl https://lingdongapi.com/v1/video/generations/task_abc123xyz \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "code": "success",
  "data": {
    "task_id": "task_abc123xyz",
    "status": "IN_PROGRESS",
    "progress": "60%",
    "result_url": ""
  }
}

{
  "code": "success",
  "data": {
    "task_id": "task_abc123xyz",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://lingdongapi.com/v1/videos/task_abc123xyz/content"
  }
}

获取视频文件

<!-- 直接使用 result_url 作为视频源 -->
<video controls width="720">
  <source src="https://lingdongapi.com/v1/videos/task_abc123xyz/content" type="video/mp4">
</video>

# -L 跟随重定向，直接下载 MP4 文件
curl -L "https://lingdongapi.com/v1/videos/task_abc123xyz/content" \
  -o output.mp4

完整代码示例

以下示例演示从提交任务到获取视频 URL 的完整流程，包含轮询逻辑。

Python 完整示例

import time
import requests

API_KEY = "sk-xxxxxxxxxxxxxxxxxxxxxxxx"
BASE_URL = "https://lingdongapi.com/v1"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# 第一步：提交视频生成任务
resp = requests.post(
    f"{BASE_URL}/videos/generations",
    headers=HEADERS,
    json={
        "model": "sora-2",
        "prompt": "A golden retriever running on the beach at sunset, cinematic 4K",
        "duration": 5,
        "orientation": "landscape"
    }
)
task_id = resp.json()["data"]["task_id"]
print(f"任务已提交，task_id: {task_id}")

# 第二步：轮询任务状态（每 10 秒查询一次，最多等待 10 分钟）
for i in range(60):
    time.sleep(10)
    query = requests.get(
        f"{BASE_URL}/video/generations/{task_id}",
        headers=HEADERS
    ).json()
    status = query["data"]["status"]
    progress = query["data"].get("progress", "0%")
    print(f"[{i+1}] 状态: {status}，进度: {progress}")

    if status == "SUCCESS":
        video_url = query["data"]["result_url"]
        print(f"✅ 视频生成成功！\n播放地址: {video_url}")
        break
    elif status == "FAILURE":
        print(f"❌ 生成失败: {query['data'].get('fail_reason', '未知原因')}")
        break
else:
    print("⏱ 超时，请稍后手动查询任务状态")

Node.js 完整示例

const API_KEY = 'sk-xxxxxxxxxxxxxxxxxxxxxxxx';
const BASE_URL = 'https://lingdongapi.com/v1';
const headers = {
  'Authorization': `Bearer ${API_KEY}`,
  'Content-Type': 'application/json',
};

// 第一步：提交任务
const submitRes = await fetch(`${BASE_URL}/videos/generations`, {
  method: 'POST',
  headers,
  body: JSON.stringify({
    model: 'sora-2',
    prompt: 'A golden retriever running on the beach at sunset, cinematic 4K',
    duration: 5,
    orientation: 'landscape',
  }),
});
const { data: { task_id } } = await submitRes.json();
console.log(`任务已提交，task_id: ${task_id}`);

// 第二步：轮询状态
const poll = async () => {
  for (let i = 0; i < 60; i++) {
    await new Promise(r => setTimeout(r, 10000));
    const res = await fetch(`${BASE_URL}/video/generations/${task_id}`, { headers });
    const { data } = await res.json();
    console.log(`[${i+1}] 状态: ${data.status}，进度: ${data.progress}`);
    if (data.status === 'SUCCESS') {
      console.log(`✅ 视频生成成功！\n播放地址: ${data.result_url}`);
      return data.result_url;
    }
    if (data.status === 'FAILURE') {
      console.error(`❌ 生成失败: ${data.fail_reason}`);
      return null;
    }
  }
  console.warn('⏱ 超时');
};

const videoUrl = await poll();

模型列表接口

curl https://lingdongapi.com/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx"

模型与定价

以下为当前全部可用模型及价格，所有价格以 人民币（¥） 计算。

文本对话模型（按 Token 计费）

图像生成模型（按次计费）

视频生成模型（按次计费）

错误码

常见问题