pic · Kolors 文生图

1. 直接调硅基流动（任何语言都能用）

本页用的就是下面这个接口。任何程序只要能发 HTTPS POST，就能出图。

POST https://api.siliconflow.cn/v1/images/generations
Authorization: Bearer <你的Key>
Content-Type: application/json

{
  "model": "Kwai-Kolors/Kolors",
  "prompt": "一只橘猫坐在窗台上看雪",
  "negative_prompt": "低质量, 模糊",
  "image_size": "1024x1024",
  "batch_size": 1,
  "num_inference_steps": 20,
  "guidance_scale": 7.5,
  "seed": 12345
}

返回 {"images":[{"url":"https://s3.siliconflow.cn/..."}]}。

返回的 URL 是 1 小时过期的临时签名地址，必须立刻下载保存，不要只存链接。

2. curl

curl -X POST https://api.siliconflow.cn/v1/images/generations ^
  -H "Authorization: Bearer %SF_KEY%" ^
  -H "Content-Type: application/json" ^
  -d "{\"model\":\"Kwai-Kolors/Kolors\",\"prompt\":\"一只橘猫\",\"image_size\":\"1024x1024\",\"batch_size\":1}"

3. Python（本机已有现成封装 kolors.py）

# CLI：D:\pros\free-ai\kolors.py（密钥读 .env，不用写在代码里）
cd /d/pros/free-ai
py kolors.py "一只橘猫坐在窗台看雪" -n "低质量,模糊" --size 1024x1024
py kolors.py "提示词" --json          # 只输出 JSON，方便别的程序解析

# 作为库调用
import kolors
files = kolors.generate("一只橘猫", size="1024x1024", batch=2)
# → ['D:\\pros\\free-ai\\outputs\\Kolors_20261025-210235_1.png', ...]

4. 本机 HTTP 服务（不想让别的程序碰密钥时用这个）

py D:\pros\free-ai\web.py 起服务后，其他程序调用本地即可，密钥只留在服务端：

POST http://127.0.0.1:7860/api/generate
Content-Type: application/json

{"prompt":"一只橘猫","image_size":"1024x1024","batch_size":1}

# 返回
{"files":["Kolors_20261025-210235_1.png"],"seconds":4.0}
# 图片取：GET http://127.0.0.1:7860/outputs/<文件名>

5. 参数

字段	说明
model	Kwai-Kolors/Kolors（本页固定，免费模型，不提供其他选择）
image_size	1024x1024 / 768x1024 / 720x1280 / 1024x768 / 1280x720
batch_size	1–4，一次出几张
num_inference_steps	20 够用，30+ 更细更慢
guidance_scale	7.5 默认；画面跑偏就调高
seed	固定后同一提示词可复现

列模型：GET https://api.siliconflow.cn/v1/models?type=image（注意参数是 type=image，写 type=text-to-image 会返回空）。