LightCC 按量调用 API 文档

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

第三方服务

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

1、绘图模型

模型支持

模型名	中文名	分组	价格
gemini-3-pro-image-preview	大香蕉2 Pro	优惠	0.42
gemini-3-pro-image-preview	大香蕉2 Pro	优质	0.78
gemini-3.1-flash-image-preview	大香蕉2	优惠	0.18
gemini-3.1-flash-image-preview	大香蕉2	优质	0.4
nano-banana-pro	大香蕉2 Pro (官方版)	官方	1.6
nano-banana-2	大香蕉2 (官方版)	官方	0.85

①、基于image请求方式

POST /system/api/v1/images/generations

参数名	位置	类型	必填	中文名	说明
server-group	header	String	否	分组	discount：优惠 premium: 优质 official: 官方如果没设置默认为优惠、优质
model	body	String	是	模型名	使用的模型
prompt	body	String	是	文本提示	文本提示词
image	body	Array	否	引用图片	url地址
aspect_ratio	body	String	否	图片比例	生成图片比例大小，默认1:1
size	body	String	否	图片大小	1k、2k、4k

请求参考体：

json

{
    "model": "gemini-3-pro-image-preview",
    "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
    "aspect_ratio": "1:1"  // 图片比例选择：1:1、2:3、3:2、4:3、4:5、5:4、9:16、16:9
    "size": "1K"  // 图片大小：1K、2K、4K
}

响应参考体：

json

{
    "model": "gemini-3-pro-image-preview",
    "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"
        }
    ]
}

②、兼容Chat请求方式

POST /system/api/v1/chat/completions

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

名称	位置	类型	必填	中文名	说明
server-group	header	String	否	分组	discount：优惠 premium: 优质 official: 官方如果没设置默认为优惠、优质
model	body	String	是	模型名	使用模型
messages	body	Array	是	消息体	会话内容
role	body	String	是	角色	值唯一：user
content	body	Array	是	内容体	主要提示词和图片，内容参考下方请求体

请求体参考：

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/png"
                }
            ]
        }
    ],
    "extra_body":{
        "google":{
            "aspect_ratio":"1:1",
            "image_size":"2K"
        }
    }
}

响应体参考

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
    }
}

2、会话模型

模型名	中文名	分组	输入价格（百万Token）	输出价格（百万Token）
gemini-3-pro-preview	--	优惠	5	29
claude-sonnet-4-6	--	优惠	4.5	22
claude-opus-4-6	--	优惠	7.5	45
gpt-5.4	--	优惠	4	22

①、Chat请求方式

POST /system/api/v1/chat/completions

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

名称	位置	类型	必填	中文名	说明
server-group	header	String	否	分组	discount：优惠 premium: 优质 official: 官方
model	body	String	是	模型名	使用模型
messages	body	Array	是	消息体	会话内容
role	body	String	是	角色	值唯一：user
content	body	Array	是	内容体	主要提示词和图片，内容参考下方请求体

请求体参考：

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/png"
                }
            ]
        }
    ],
    "extra_body":{
        "google":{
            "aspect_ratio":"1:1",
            "image_size":"2k"
        }
    }
}

响应体参考

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
    }
}

3、视频模型

doubao-seedance-2-0-260128

创建任务：Post /v3/contents/generations/tasks 和官方一直获取结果：Get /v3/contents/generations/tasks/{taskId}

获取服务可用状态

GET /system/api/serverStatus/{modelName}

json

{
    "msg": "操作成功",
    "code": 200,
    "data": {
        "premium": 0, // 0 表示没有服务    1 表示有服务
        "discount": 1,
        "official": 0
    }
}

图片上传

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

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

请求参数

名称	位置	类型	必选	中文名	说明
fileType	path	string	是	文件后缀名	例如：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"
  }
}

名称	类型	备注
fileName	String	文件名，工作流中如果需要图片则使用这个名称
preUrl	String	图片预下载链接，用于后续的文件地址使用
url	String	工作流图片的上传地址

LightCC 按量调用 API 文档 ​

第三方服务 ​

1、绘图模型 ​

①、基于image请求方式 ​

②、兼容Chat请求方式 ​

2、会话模型 ​

①、Chat请求方式 ​

3、视频模型 ​

doubao-seedance-2-0-260128 ​

获取服务可用状态 ​

图片上传 ​

请求参数 ​

响应参数 ​

LightCC 按量调用 API 文档

第三方服务

1、绘图模型

①、基于image请求方式

②、兼容Chat请求方式

2、会话模型

①、Chat请求方式

3、视频模型

doubao-seedance-2-0-260128

获取服务可用状态

图片上传

请求参数

响应参数