星算云 开发者文档

主题

可灵 3.0 视频生成(按秒计费) ​

星算云可灵(Kling)3.0 视频网关挂载于 /kling,对外提供 kling-3.0 系列模型(文生视频 / 图生视频 / Omni 全能视频生成,按秒计费)。请求体与响应体沿用可灵官方格式原样透传,平台仅做鉴权、模型校验与按秒计费;鉴权用 Authorization: Bearer xsk_...。

与 Seedance(火山兼容) 等 /api/v3 端点、MiniMax H3 的 /v2 端点区别:本网关只接 provider 为 KLING 的 VIDEO 模型(kling-3.0 / kling-3.0-turbo / kling-3.0-omni);其他模型请走各自端点。

基础信息 ​

项目内容
Base URLhttps://xingsuan.cloud/kling(平台地址 + /kling 命名空间)
创建·文生视频POST /kling/text-to-video/{model_code}
创建·图生视频POST /kling/image-to-video/{model_code}
创建·Omni 全能POST /kling/omni-video/{model_code}
查询任务GET /kling/tasks?task_ids=a,b,c(批量,逗号分隔,≤20)
Content-Typeapplication/json
鉴权 HeaderAuthorization: Bearer xsk_...(平台 API Key)

API Key 安全

只在服务端保存 API Key,不要放入浏览器、公开仓库或客户端安装包。

模型 ​

模型代码说明
kling-3.03.0 标准档,文生 / 图生视频(首帧/首尾帧);分辨率 720p / 1080p / 4k,时长 3~15 秒,支持有声(settings.audio: native)与无声
kling-3.0-turbo3.0 极速档,文生 / 图生视频(首帧);分辨率 720p / 1080p,时长 3~15 秒
kling-3.0-omni3.0 Omni 全能档,参考图 / 参考视频(feature_video / base_video)/ 主体 / 视频编辑;分辨率 720p / 1080p / 4k,支持 original(保留参考视频原声)

模型代码即可灵官方模型名;价格与可用档位以平台「模型市场」展示为准。

计费 ​

按「生成视频秒数 × 分辨率·有声·参考视频组合单价」计费,以平台模型配置价格与 API Key 折扣为准,从账户钱包实时扣减。任务失败不收取费用。

  • 计费秒数:以任务成功后响应 outputs[].duration(生成视频时长,四舍五入到整秒)为准;未回报时按请求 settings.duration(缺省 5 秒)。
  • 有声 / 无声:settings.audio 为 native / original 按「有声」价,off 或缺省按「无声」价(turbo 档为单一价,与 audio 无关)。
  • 参考视频:Omni 请求 contents 含 feature_video / base_video 时按「有参考视频」价;首尾帧 / 参考图 / 主体均按「无参考视频」价。
  • 分辨率:以请求 settings.resolution 为准(缺省 720p)。
  • aspect_ratio / multi_shot / 水印不影响价格。

具体单价见平台「模型市场」对应模型的价格表。

创建任务 ​

POST /kling/text-to-video/kling-3.0

bash
API_BASE=https://xingsuan.cloud/kling
curl "$API_BASE/text-to-video/kling-3.0" \
  -H "Authorization: Bearer $XSK_KEY" \
  -H "content-type: application/json" \
  -d '{
    "prompt": "一个女孩坐在火车上，望着窗外，神情忧郁，头随着火车轻轻摇晃",
    "settings": {
      "resolution": "1080p",
      "aspect_ratio": "16:9",
      "duration": 5,
      "audio": "off"
    },
    "options": { "watermark_info": { "enabled": false } }
  }'
python
import httpx

API_BASE = "https://xingsuan.cloud/kling"
r = httpx.post(
    f"{API_BASE}/text-to-video/kling-3.0",
    headers={"Authorization": f"Bearer {XSK_KEY}"},
    json={
        "prompt": "一个女孩坐在火车上，望着窗外，神情忧郁，头随着火车轻轻摇晃",
        "settings": {
            "resolution": "1080p",
            "aspect_ratio": "16:9",
            "duration": 5,
            "audio": "off",
        },
        "options": {"watermark_info": {"enabled": False}},
    },
    timeout=30,
)
print(r.json())  # {"code": 0, "message": "ok", "request_id": "...",
                 #  "data": {"id": "8936...", "status": "submitted", ...}}

响应为可灵官方信封,原样透传:

json
{
  "code": 0,
  "message": "ok",
  "request_id": "string",
  "data": {
    "id": "893605946402811985",
    "status": "submitted",
    "create_time": 1781080778802,
    "update_time": 1781080794151,
    "external_id": ""
  }
}

data.id 即任务 ID(纯数字串),用于后续查询。

图生视频 / Omni ​

  • 图生视频(POST /kling/image-to-video/{model_code}):contents 数组携带 prompt 文本与 first_frame(及 last_frame)图片 URL,结构与官方一致。
  • Omni(POST /kling/omni-video/{model_code}):contents 可混排 prompt / first_frame / last_frame / refer_image / feature_video(特征参考视频)/ base_video(待编辑视频)/ element(主体),配合 settings.audio(native / original / off)与 multi_shot。

平台差异(相对可灵官方)

  • options.callback_url 与 options.external_task_id 不支持(已剥离):任务状态请通过查询接口轮询获取;external_task_ids 查询参数同样不支持。
  • 查询仅支持 task_ids(系统任务 ID,逗号分隔,单次最多 20 个)。
  • 其余字段(含 options.watermark_info)原样透传,规则以上游裁决为准(分辨率/时长/参考素材数量等错误体原样返回)。

查询任务 ​

GET /kling/tasks?task_ids=893605946402811985

bash
API_BASE=https://xingsuan.cloud/kling
curl "$API_BASE/tasks?task_ids=893605946402811985" \
  -H "Authorization: Bearer $XSK_KEY"

响应为可灵官方信封(data 数组),原样透传:

json
{
  "code": 0,
  "message": "ok",
  "request_id": "string",
  "data": [
    {
      "id": "893605946402811985",
      "status": "succeeded",
      "message": "",
      "create_time": 1781080778802,
      "update_time": 1781080794151,
      "external_id": "",
      "outputs": [
        {
          "type": "video",
          "id": "string",
          "url": "https://.../video.mp4",
          "watermark_url": null,
          "duration": "5"
        }
      ],
      "billing": [
        {
          "charge_type": "cash",
          "cash_type": "balance",
          "amount": "0.80",
          "currency": "CNY",
          "list_price": "0.80"
        }
      ]
    }
  ]
}
  • 状态机:submitted(已提交)→ processing(处理中)→ succeeded(成功)/ failed(失败)。
  • 首次查询到 succeeded 时平台完成按秒计费(此后重复查询不会重复扣费);failed 不计费。
  • 产物 url 为防盗链地址,上游 30 天后清理,请及时下载或转存(过期后重新查询可获取新地址)。

错误格式 ​

平台校验类错误统一返回可灵风格信封(非 0 code + message + request_id):

json
{ "code": 401, "message": "invalid api key", "request_id": "..." }

常见:无效 API Key(401)、余额不足(402)、模型未授权/任务无归属(403/404)、额度超限(429)、参数或价格档位未配置(400)。上游错误体原样透传。

Copyright © 2026 星算云