LightCC光算云文档

切换主题

LightCC 按量调用 API 文档 ​

💡 提示：在使用本 API 之前，请先阅读 API接入指南，了解如何申请密钥和进行身份认证。

第三方服务 ​

通过聚合多个第三方接口，非官方模型可实现动态调度与智能切换，在保障服务高可用的同时显著提升系统稳定性。该机制能够实时监测各接口的响应质量与健康状态，自动优选最优路径，并在异常发生时无缝切换至备用通道，从而有效规避单点故障，确保服务连续、可靠、高效运行。

1、Gemini ​

备注：gemini-banana2 开头模型调用的是官方渠道，价格和官方一致，

模型支持

模型名中文名价格（元）像素大小
gemini-2.5-flash-image大香蕉10.051k
gemini-3-pro-image-preview大香蕉2-1k0.241k
gemini-3-pro-image-preview-2k大香蕉2-2k0.242k
gemini-3-pro-image-preview-4k大香蕉2-3k0.244k
gemini-banana2-1k大香蕉2-1k(官方版)11k
gemini-banana2-2k大香蕉2-2k(官方版)12k
gemini-banana2-4k大香蕉2-4k(官方版)1.84k

①、基于Chat请求方式 ​

POST /system/api/v1/task/chat/completions

使用OpenAI的Chat请求格式使用。参考OpanAI的chat/completions请求格式，注意：content属性只能接受数组，不再接受单个文本。

名称位置类型必填中文名说明
modelbodyString是模型名使用模型
messagesbodyArray是消息体会话内容
rolebodyString是角色值唯一：user
contentbodyArray是内容体主要提示词和图片，内容参考下方请求体

请求体参考：

json
{
    "model": "gemini-2.5-flash-image",
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "text": "Replace the character in the current picture with a tiger",
                    "type": "text"
                },
                {
                    "image_url": {
                        "url": "http://xxxx.png"// 支持URL ，可使用文档中图片上传接口，
                    },
                    "type": "image_url"
                }
            ]
        }
    ]
}

响应体参考

json
{
    "id": "chatcmpl-20251028091659663389599SQD6nmal",
    "created": 1761614225,
    "model": "gemini-2.5-flash-image",
    "choices": [
        {
            "index": 0,
            "message": [
                {
                    "content": "https://minio3.lightcc.cloud/task-image/save_img/xxxx.png",
                    "role": "assistant"
                }
            ],
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 12,
        "completion_tokens": 1290,
        "total_tokens": 1302
    }
}

②、基于image请求方式 ​

POST /system/api/v1/task/images/generations

参数名位置类型必填中文名说明
modelbodyString是模型名使用的模型
promptbodyString是文本提示生成效果描述
imagebodyArray否引用图片url地址
sizebodyString否图片比例生成图片比例大小，默认1:1

请求参考体：

json
{
    "model": "gemini-3-pro-image-preview-4k",
    "prompt": "将图1的服装换为图2的服装",
    "image": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png", 
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imagesToimage_2.png"
    ], // 图片只支持URL
    "size": "1:1"  // 图片比例选择：1:1、2:3、3:2、4:3、4:5、5:4、9:16、16:9
}

响应参考体：

json
{
    "model": "gemini-3-pro-image-preview-4k",
    "created": 1768007879,
    "data": [
        {
            "url": "https://minio3.lightcc.cloud/task-image/save_img/80a4530c7a55450c85f0d1fa6deb8e6b.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=s5lOkr2l4r3O9PyK7VyY%2F20260110%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260110T011800Z&X-Amz-Expires=259200&X-Amz-SignedHeaders=host&X-Amz-Signature=9f941c368000e5a559304819d68b890c289cfc2c273fab63322eb72348ac92e4"
        }
    ]
}

2、豆包 ​

① 基于image请求方式 ​

POST /system/api/v1/task/images/generations

模型支持

模型名价格
doubao-seedream-4-0-2508280.12
doubao-seedream-4-5-2511280.18

请求参数参考官方格式：https://www.volcengine.com/docs/82379/1541523。特别注意：不支持流式输出，一次限制生成一张图片。价格是根据第三方服务定制的价格，可能会有所浮动。

json
{
    "model": "doubao-seedream-4-0-250828",
    "prompt": "星际穿越，黑洞，黑洞里冲出一辆快支离破碎的复古列车，抢视觉冲击力，电影大片，末日既视感，动感，对比色，oc渲染，光线追踪，动态模糊，景深，超现实主义，深蓝，画面通过细腻的丰富的色彩层次塑造主体与场景，质感真实，暗黑风背景的光影效果营造出氛围，整体兼具艺术幻想感，夸张的广角透视效果，耀光，反射，极致的光影，强引力，吞噬",
    "size": "2K",
    "response_format": "url",
    "watermark": true
}

响应值

json
{
    "model": "doubao-seedream-4-0-250828",
    "created": 1761614093,
    "data": [
        {
            "url": "https://minio3.lightcc.cloud/task-image/save_img/xxxx.png"
        }
    ]
}

3、Sora2 ​

模型名三方价格（按次收费）备注官方价格（按秒收费）
sora-20.18、0.45sora屏蔽国内三方暂不可用0.9 / s；总价：3.6/4s、7.2/8s、10.8/12s
sora-2-pro4.322.7 ~ 4.5 / s; 像素+时间

注意：每个用户创建的任务最多3个，需等待任务执行结束，才可以创建新的任务。官方版：图片限制严格，选用像素是多少，那参考图片保持一致。

①、三方渠道请求方式 ​

POST /system/api/v1/task/video/generations 请求格式：application/json

名称位置类型必填中文名说明
modelbodyString是模型名使用模型：sora-2、sora2-pro
promptbodyString是消息体提示词
imagebodyString否参考图片图片地址，只支持URL
secondsbodyInt是视频时长10s、15s、25s，其中25s只有sora2-pro支持
sizebodyString是像素大小9:16 、16:9

请求参考

json
{
    "model":"sora-2",
    "prompt":"模拟第一人称视角探险，FPV视角，手握手电筒，镜头伴随动作轻微晃动。",
    "seconds":15, // 可用参数：10 、 15 、25 秒
    "image":"https://xxxxxxxxxx/xxxxx.png",
    "size":"9:16" // 可用参数：9:16 、16:9
}

响应参考

json
{
    "taskId": "video_b0f05020_ed52_4284_8c08_a96dbd1d24ed",// 任务id
    "model": "sora-2", // 使用的模型
    "status": "queued", // queued 等待 progress 运行 completed 完成 failure 失败
    "progress": 0 // 任务进度
    "error":{// 创建错误信息
        "type":"xxxxx", // 错误类型
        "message":"xxxx" // 错误消息
    }
}

②、官方渠道请求方式 ​

POST /system/api/v1/task/openai/video 请求格式：multipart/form-data

名称位置类型必填中文名说明
modelbodyString是模型名使用模型：sora-2、sora2-pro
promptbodyString是消息体提示词
input_referencebodyFile否参考图片图形文件：注意图片大小和设置的size相同
secondsbodyInt是视频时长4s、8s、12s，其中12s只有sora2-pro支持
sizebodyString是像素大小720x1280、1280x720、1024x1792、1792x1024

请求参考

curl
curl --location 'https://api.lightcc.cloud/system/api/v1/task/openai/videos' \
--header 'x-api-key: xxxxxx' \
--form 'model="sora-2"' \
--form 'prompt="Put a hat on the cat"'
--form 'input_reference=@"/path/to/file"' \
--from 'seconds=4'
--from 'size="720x1289"'

响应参考

json
{
    "taskId": "video_b0f05020_ed52_4284_8c08_a96dbd1d24ed",// 任务id
    "model": "sora-2", // 使用的模型
    "status": "queued", // queued 等待 progress 运行 completed 完成 failure 失败
    "progress": 0 // 任务进度
    "error":{// 创建错误信息
        "type":"xxxxx", // 错误类型
        "message":"xxxx" // 错误消息
    }
}

③、获取任务执行结果 ​

GET：/system/api/v1/task/video/generations/{taskId}

异步生成，一般生成时间在三到六分钟。

名称位置类型必选中文名说明
taskIdpathString是任务id创建视频所得的任务Id

响应参考：

json
{
    "taskId": "video_b0f05020_ed52_4284_8c08_a96dbd1d24ed",
    "model": "sora-2",
    "status": "completed", 
    "progress": 100,
    "createTime": 1769044095,
    "startTime": 1769044108,
    "endTime": 1769044328,
    "videoUrl": "https://minio3.lightcc.cloud/task-image/save_img/xxxx.mp4"
    "error":{// 运行错误信息
        "type":"xxxxx", // 错误类型
        "message":"xxxx" // 错误消息
    }
}

图片上传 ​

GET /system/api/v1/task/minio/uploadPath/{fileType}

上传预签名，通过调用该接口可以获取一个指定类型的上传链接和文件名称，通过PUT方法可以将所需的图片上传。URL地址3分钟内有效

请求参数 ​

名称位置类型必选中文名说明
fileTypepathstring是文件后缀名例如：png、jpg

响应参数 ​

json
{
  "msg": "操作成功",
  "code": 200,
  "data": {
    "fileName": "718d643fe0b145acb8f5d1d96eca2773.png",
    "preUrl": "https://minio3.lightcc.cloud/task-image/upload_img/718d643fe0b145acb8f5d1d96eca2773.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=s5lOkr2l4r3O9PyK7VyY%2F20260120%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260120T035251Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=6f2413cffc45962a3a31e834091fc0d10d1383d39b02c46f8ba08375ed25f438",
    "url": "https://minio3.lightcc.cloud/task-image/upload_img/718d643fe0b145acb8f5d1d96eca2773.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=s5lOkr2l4r3O9PyK7VyY%2F20260120%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260120T035251Z&X-Amz-Expires=180&X-Amz-SignedHeaders=host&X-Amz-Signature=ede82e4e991c611edd521ca7cea72af40dcc9c170d440d39858251d6485ccf3c"
  }
}
名称类型备注
fileNameString文件名，工作流中如果需要图片则使用这个名称
preUrlString图片预下载链接，用于后续的文件地址使用
urlString工作流图片的上传地址