文生图

更新时间：2026-01-12 13:48:20

文生图API能基于用户输入的内容，生成符合语义描述的图片。

POST

https://cloud.baicaiinfer.com/v1/images/generations

Authorizations

Authorizations：StringHeaderRequired

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

Body

application/json

selected_model：StringRequired

模型名称，取值：FLUX.2-dev。更多模型，可参考支持的模型和应用。

task_type：StringRequired

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

response_format：String

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

inference_tier：String

本次任务的调用模式，不同模式对应不同的计费标准。取值：FASTEST（极速）、STANDARD（标准）、ECONOMICAL（经济），默认值：FASTEST。

input：ObjectRequired

生成式模型（如图像生成）的核心参数集合。

input.prompt：StringRequired

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

input.negative_prompt：String

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

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

调节模型在生成时遵循文本提示词的程度，数值越大生成内容与提示词越一致，但可能降低多样性或导致过饱和，取值：0~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

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

400

500

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

Python

JavaScript

curl --location --request POST 'https://cloud.baicaiinfer.com/v1/images/generations' \
--header 'Authorization: Bearer sk-VStOhW7gwGTcy5lFuDg*****' \
--header 'Content-Type: application/json' \
--data-raw '{
    "selected_model": "FLUX.2-dev",
    "task_type": "txt2img",
    "input": {
        "prompt": "a beautiful young woman, realistic face, detailed eyes, soft natural lighting, high-resolution portrait, 8K, ultra-detailed skin texture, cinematic lighting, professional photography, sharp focus",
        "width": 1024,
        "height": 1024
    }
}'

200

400

401

404

500

// 以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"
        ]
    }
}