跳到主要内容

文生图

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

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

Body
application/json
selected_model：StringRequired

模型名称。更多模型，可参考支持的模型和应用。

取值范围：HunyuanDiT
默认值：-
约束限制：-
task_type：StringRequired

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

取值范围：txt2img
默认值：-
约束限制：-
response_format：String

特定的输出格式。

取值范围：url、b64_json
默认值：url
约束限制：-
inference_tier：String

本次任务的调用模式，不同模式对应不同的计费标准。

取值范围：FASTEST（极速）、STANDARD（标准）、ECONOMICAL（经济）
默认值：FASTEST
约束限制：-
input：ObjectRequired

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

input.prompt：StringRequired

用于生成图像的正向提示词。

取值范围：1~1000
默认值：-
约束限制：支持中英文。
input.negative_prompt：String

用于指定生成图像时需避免的元素（如低质量、失真等）的反向提示词。

取值范围：1~500
默认值：-
约束限制：支持中英文。
input.width：IntRequired

指定生成图像的宽度，单位像素，用于定义输出图像在水平方向上的尺寸。

取值范围：1~5404
默认值：-
约束限制：-
input.height：IntRequired

指定生成图像的高度，单位像素，用于定义输出图像在垂直方向上的尺寸。

取值范围：1~5404
默认值：-
约束限制：若提供的 width 和 height 的具体像素值，不满足16倍数，系统会相应自动调整。
input.number_of_images：Int

指定生成图像的数量。

取值范围：1~4
默认值：1
约束限制：-
input.num_inference_steps：Int

指定生成模型迭代优化的次数，次数越多生成图像细节越精细、质量越高，但同时会增加生成耗时。

取值范围：1~50
默认值：28
约束限制：-
input.true_cfg_scale：Float

调节模型在生成时遵循文本提示词的程度，数值越大生成内容与提示词越一致，但可能降低多样性或导致过饱和。

取值范围：1~20
默认值：9.0
约束限制：-
input.strength：Float

控制生成图像对原始输入图像的保留程度，值越高则对原图的改变越大，反之越接近原图。

取值范围：0~1
默认值：0.75
约束限制：-
input.seed：Int

生成式模型中控制结果随机性的种子，固定它可复现相同结果，改变则生成不同内容。

取值范围：-1~4294967295
默认值：-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可直接下载或在线查看图片文件，适合需要快速预览或通过链接分享的场景。

data.b64_json：String

是图像文件经Base64编码后的字符串，需解码后才能还原为图像数据，适合无法直接访问外部链接（如内网环境）或需要本地直接处理图像的场景。

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": "HunyuanDiT",
    "task_type": "txt2img",
    "input": {
        "prompt": "小狗晒太阳",
        "width": 1024,
        "height": 1024
    }
}'

// 以url格式输出的结果：
{
    "status": 0,
    "message": "success",
    "created": 1772687633,
    "data": {
        "url": [
            "https://s1.llamafactory.online/baicai-infer/results/7bea7234494544699e6f8186e44c09ba/0a8ee24016fc47f39a9a3d4c430c1c63.png"
        ],
        "upload_times": [
            0.38452588580548763
        ],
        "time_cost": 5.149594494141638,
        "url_wm": [
            "https://s1.llamafactory.online/baicai-infer/results/7bea7234494544699e6f8186e44c09ba/qbOgC3qAriBbpktWK3e1SjDe5f9DtwR0u1LVb3wkiuiYxnuOdiS700GjPYMIxQSx.png"
        ]
    }
}

// 以b64_json格式输出的结果：
{
    "status": 0,
    "message": "success",
    "created": 1772687633,
    "data": {
        "b64_json": [
            "iVBORw0KGgoAAAANSUhEUgAABAAAAAQACAIAAADwf7zUAAEAAElEQVR4nFT9TZckSbIdiN0rImoeEVnVrx8OBsPhIbkkfwe3XPH/73hmBYIAXndVZoSbisjlQtSjego4OI3MSA9zMzVVkfsl/H/+v/9fBEhUNqFuAYCZuklIIilJgJEAJHU3SakhACBYld1FGKDOJGERNDOa1JVZmZLUqiqP6O5WGT0iSLZ6/gNwrRURBM0MEGmZed83gaoCCUKS0QCQpFtXE6IZAZAABaha3SSf921ukAB1N6QuGZG5MV8Mks73gs5/AABIIEFy7ou6WyIAkMb54fkbnXuiuSgAggjOlzo/M/+WlESiJYKkvX7XuRQ3EyAI4vwCzOeBAOZrmllVz0/193f4l/+3q0V0nauayzgXbvYvvxB8/YWkuWbNLwcBnb8l0KLNVyPJ+c5zfyCRJPG6bQDpbjb/YP4OApiZxPd3mV8oc5/7L/X5M5wfAmikVOfeSiII2vlwZFZWmZmZm1EtQOTcJM23VSuzZgEQEAXw7e09d2YlXgsbgNl8O5iRpOYWzL0gSNPrZhiJeQVAGiUZCJoESDTc97NaBMP9+xa35lmRAI3zsfvegrq1rss91L33BuRuBDycIAQzEwGoq7tb3RJoRjKMBFpNMNbKvUFADfG6VmXOaiXZLTcD0VXuZq/HCWBeKDuLk62ep/z6J+wud1Orqi2ss2e1m5sZW22ku0OQsCKEVnesqyvnUe59z7tJwD0ImM0rA3dTVbiZ2a4S4ObqNvPMTTLCZ8XMcnIzos+rZHZe2z7Lf3YCI82cZlVFotVQr3W5WVeShAiyu0mAIMmzYg1Sd83rwFlXhBpdAiH1WsvIWfmzrmY5tGDmeu02RgoiseKajeustNnHZrc9b4fc3IxdDVI4K0/SXJW6q8s9zsYDAHS3qtmoMU9tnipBEPPgZnOdReduUEuzl1p3z++Yuyq1+aw7CTTSzKQ2s3mV0Oq5y4IMbvN+Nfq8GYLOcjKz1/8AoFZ1mTHWqqzuprGyzG3uwfywzw+/1mRWVpfR3JxmZtbdVTk7wdmghddBU3MNr3sICF3l4aR1N2nZBSDCAXRlVasVHuYu9JxK82YZbXbm8z3UmONQJJmZ7g7JzNUFAjR3lzqrumRmkGhWahLVTZqbg8hMdc0ebuERK2JRyNyz0ahK88kAoG5J8gjCzs1/LQaoYy3CqtLcCGqO0uqdSfLx/gbQjV9fTxC///7bcz/neQmoOqe6VN+bSXXvfRst3M29hVZn5r2zG2tdXdVKCWb08OfzDl/0+Pnzp7uTfldmpoCIBfL5/MqqnvN5TolZ9WBDpJnF5+dnrKjKiOiu7o71qKrnfWcVQAktmXFqgFYDMBho5v7b778976+3x9v7+/v/97/91//yn//X59fn59dPwv+3/+3//I8//vnPf/zj/e0Hre/7+fHjxx9//HRf/+V/+V9//vzjn//8x+PxqCqof/z4cT2uve+I9fb2ZuR//a//de/8v/xf/28776wq6fPz67Eudz6u6/Prq1L/9//H/+N//9//P//tv/03o398/Lge648//+G23t7fpf7561d4hNvX88vI//Sf//P//J//cT/3x8fHrv32uP7Tv//9f/yP//j8enbJrvX5+cXSiis7fXl4XI/169fPyoq4KD0el4d9fX5dj0dVX9cFIPPuKjN7vP3Irty3Gc2w9368va+Ive+sJs3MAbg5ie4CkFmxLhLqUktQRHg41F26rgtQVa5rfby9ARQtpfv5hPr98QbQwiBkVay19w6zx+PNiOqOK9xYWetaz31/vL/929/+3lmfX5975/vHjwh/Pj+fz3tdj4jos6MS0NvjknTfN80FxIprrRXhy2nszJ3b/IpYa10knl+/VHVeHAFkdVemu6+1fIWIbLmHnQ0StLOFruvqRncZWF133kaH2uiCdubj8XDjvr+qSq1rPVpyi5bUVVXZGWtBiAgjs0tnf4KkzlrXJaAhNYwmyt3nPK+eXdhU5T6VrWEOYJ6yYe88BZjaLKp7zk2"
        ],
        "url": [
            "https://s1.llamafactory.online/baicai-infer/results/7bea7234494544699e6f8186e44c09ba/0a8ee24016fc47f39a9a3d4c430c1c63.png"
        ],
        "upload_times": [
            0.38452588580548763
        ],
        "time_cost": 5.149594494141638,
        "url_wm": [
            "https://s1.llamafactory.online/baicai-infer/results/7bea7234494544699e6f8186e44c09ba/qbOgC3qAriBbpktWK3e1SjDe5f9DtwR0u1LVb3wkiuiYxnuOdiS700GjPYMIxQSx.png"
        ]
    }
}