跳到主要内容

文生图

更新时间：2026-01-12 11:34:20
文生图API能基于用户输入的内容，生成符合语义描述的图片。
POST
https://cloud.baicaiinfer.com/v1/images/generations
Authorizations
Authorizations：StringHeaderRequired

用户需使用已获取的API Key进行身份验证，以访问服务。

Body
application/json
selected_model：StringRequired

模型名称，取值：Kling-v2-1-T2I。更多模型，可参考支持的模型和应用。

task_type：StringRequired

指定生成式模型需执行的任务类型，取值：txt2img。更多任务类型，可参考支持的模型和应用。

response_format：String

允许强制模型产生特定的输出格式，默认值：url。

input：ObjectRequired

生成式模型的核心参数集合。

input.prompt：StringRequired

是生成图像时用于描述期望内容（如场景、风格、细节等）的正向提示词，指导模型生成符合需求的图像。

input.resolution：StringRequired

分辨率（取值：1k、2k）。

input.aspect_ratio：String

指定生成图像的宽高比（取值：1:1、2:3、3:2、3:4、4:3、9:16、16:9、21:9），默认值：16:9。传入的resolution 、aspect_ratio值会和既定的值相匹配，如果不符合则直接报错。注意传width， height则不会生效。

input.number_of_images：Int

指定生成图像的数量，取值范围为1~4。默认值：1。

need_expand_prompt：Boolean

优化提示词（取值：true、false），默认值：false。

async：Boolean

是否采用异步方式处理请求（取值：true、false），默认值：false。

Response
状态码：
200
application/json
status：IntRequired

表示请求处理状态的状态码。

0是成功标识，表示接口正常返回预期结果。
message：StringRequired

返回请求的处理结果，通常配合状态码使用，直观告知用户当前请求的具体情况。

created：IntRequired

响应的时间戳。

data：objectRequired

任务的核心结果数据。

data.url：array[string]Required

是生成图片的网络访问链接（不带水印的），通过该URL可直接下载或在线查看图片文件，适合需要快速预览或通过链接分享的场景。

data.upload_times：array[number]Required

生成第一张图片时，预处理所花费的时间。

data.time_cost：numberRequired

整个请求从接收开始到生成完成所消耗的总时间。

data.url_wm：array[string]Required

是生成图片的网络访问链接（带水印的），通过该URL可直接下载或在线查看图片文件，适合需要快速预览或通过链接分享的场景。

curl --location --request POST 'https://cloud.baicaiinfer.com/v1/images/generations' \
--header 'Authorization: Bearer sk-5p1zwaivq2bRCfF08Vm*****' \
--header 'Content-Type: application/json' \
--data-raw '{
    "selected_model": "Kling-v2-1-T2I",
    "task_type": "txt2img",
    "input": {
        "prompt": "小狗晒太阳",
        "resolution": "1k"
    }
}'

{
    "status": 0,
    "message": "success",
    "created": 1770728799,
    "data": {
        "url": [
            "https://s1.llamafactory.online/baicai-infer/results/13428a7a1aff4d3181b6cd06b2c4fcaf/HuKeSC71fj5-xtf-nbdCUgrZ3YK0CrYmnn090w17X70Z42XgL.png"
        ],
        "upload_times": [
            0.9641020204871893
        ],
        "time_cost": 12.815634097903967,
        "url_wm": [
            "https://s1.llamafactory.online/baicai-infer/results/13428a7a1aff4d3181b6cd06b2c4fcaf/Muvv5eZQbfh4JFik9ri8uJKegb3111ODJ_V2qKzwV7U0k2g3tESNGV5eSE2flVVsWNiQoir7KhO9RcgH0HwexA.png"
        ]
    }
}