QUICKSTART

10 分钟完成第一条视频任务

本指南使用服务端调用。API Key 必须保存在环境变量或密钥管理系统中，不能写入网页、移动端或公开代码仓库。

最后更新 2026-11-02

准备接入环境

创建账户并登录进入聆光AI 控制台，创建用于服务端调用的模型 API Key。
保存环境变量设置 VIDEO_API_BASE 和 VIDEO_API_KEY，不要提交真实 Key。
查询模型请求 GET /v1/models，确认当前 Key 可用的模型 ID。
提交任务向 POST /v1/videos 发送请求，保存响应中的公开任务 ID。

环境变量bash

export VIDEO_API_BASE="https://ling-light.com"
export VIDEO_API_KEY="sk-your-api-key"

查询当前 Key 可用模型

bashbash

curl "$VIDEO_API_BASE/v1/models" \
  --header "Authorization: Bearer $VIDEO_API_KEY"

创建视频任务

bashbash

curl --request POST "https://ling-light.com/v1/videos" \
  --header "Authorization: Bearer $VIDEO_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: $(uuidgen)" \
  --data '{
    "model": "seedance2.0",
    "prompt": "一只橘猫坐在窗台上看雨，镜头缓慢推近",
    "seconds": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

轮询直到终态

bashbash

curl "$VIDEO_API_BASE/v1/videos/<TASK_ID>" \
  --header "Authorization: Bearer $VIDEO_API_KEY" \
  --header "Accept: application/json"

建议每 3 至 5 秒查询一次。completed 后读取 metadata.url；failed 后记录错误并停止轮询。

创建超时不要立即换幂等键

创建请求超时、断连或返回 5xx 时，保留原 Idempotency-Key 并查询任务或联系支持，避免重复任务和重复扣费。

完整 Node.js 示例

复制服务端创建与轮询代码。

查看 Node.js 示例

错误与状态

查看 HTTP 状态和重试建议。

阅读任务指南