跳到主要内容

快速调用示例

更新时间:2025-12-22 16:24:25

Baicai Infer白菜AIGC)平台提供开箱即用的「AI应用」,无需参数调优即可一键复现效果。本文以「旅拍vlog」应用为例,介绍如何调用API接口实现AI创作。

前提条件

当前账号的余额充裕,可满足模型推理服务的需要。可通过账户充值页面,为您的账户进行充值,如需了解更多请联系我们

获取API Key

访问API之前,需要先在推理API页面创建您的API密钥。该密钥将用于认证您对Baicai Infer API的请求。

注意

API Key仅在创建时显示一次,请妥善保存。若丢失请及时删除并创建新API Key,避免产生账户资金损失。

  1. 登录Baicai Infer平台,单击左侧导航栏的「推理服务 > API Key」,跳转至「访问管理」页面。

  2. 在「推理API」页签,单击右上方的「+ 创建API Key」按钮。

    API

  3. 在弹出的对话框中设置Key的名称,然后单击「创建」,创建成功后在弹出对话框中复制API Key信息,然后单击「我已保存」。

    在「推理API」页面可以看到已成功创建的API Key。

上传文件

访问「AI应用」API之前,需要先调用上传文件接口获取图片的路径。

  1. 请求参数。

    curl --location --request POST 'https://cloud.baicaiinfer.com/v1/resources/upload' \
    --header 'Authorization: Bearer sk-VCanjKeXkla7UHUvdmw*****' \ //已获取的API Key
    --form 'file=@"/Users/xuh/Downloads/fmJHcc-travel_memories.jpg"'
  2. 响应参数。

    {
    "code": 0,
    "message": "上传成功",
    "data": {
    "id": "7e4113a5a1284465831eaefaa0022a98",
    "message": "文件上传成功",
    "filename": "7e4113a5a1284465831eaefaa0022a98/fmJHcc-travel_memories.jpg",
    "fullPath": "https://s1.llamafactory.online/baicai-infer/users/7e4113a5a1284465831eaefaa0022a98/fmJHcc-travel_memories.jpg",
    "type": "file",
    "path": "/root/ComfyUI/input/7e4113a5a1284465831eaefaa0022a98/fmJHcc-travel_memories.jpg"
    },
    "ts": "2025-12-23T10:10:26.689242298+08:00[Asia/Shanghai]"
    }
    注意

    返回的"path"值,作为下文「发起旅拍任务」接口中"image"参数的取值。

发起「旅拍vlog」任务

  1. 请求参数。

    curl --location --request POST 'https://cloud.baicaiinfer.com/v1/comfyui/create' \
    -H 'Authorization: Bearer sk-VStOhW7gwGTcy5lFuDg*****' \ //已获取的API Key
    -H 'Content-Type: application/json' \
    --data-raw ' {
    "params":{
    "29":{
    "text":"第 1 秒:画面锁定原图,母女牵手沿花路向前走,镜头同步向前轻移,两侧繁花细节渐清晰。第 2 秒:母女裙摆随步伐轻扬,镜头微微抬升,远处湖景开始显露。第 3 秒:镜头持续向前跟拍同时缓慢向上拉升,母女手臂舒展的姿态更突出。第 4 秒:镜头继续缓慢向上拉升,视角从平视转为高角度俯瞰。第 5 秒:视角从高角度俯瞰,花路、母女与湖景构成色彩饱满的远景画面。"
    },
    "373": {
    "image":"/root/ComfyUI/input/7e4113a5a1284465831eaefaa0022a98/fmJHcc-travel_memories.jpg"
    }
    },
    "workflowId":"travel_memories"
    }
    提示

    本文以「旅拍vlog」为例为您介绍调用该接口的请求参数,对于不同的AI应用,其中"params"参数和"workflowId"参数值均不同,各AI应用的"workflowId"参数值,具体可参见支持的模型

  2. 响应参数。

    {
    "code": 0,
    "message": "任务提交成功",
    "data": {
    "taskId": "b51259bcf5114ab0b204fb93022*****"
    },
    "ts": "2025-12-23T11:06:27.568615143+08:00[Asia/Shanghai]"
    }

查询任务状态

  1. 请求参数。

    curl -X GET "https://cloud.baicaiinfer.com/v1/comfyui/tasks/b51259bcf5114ab0b204fb93022*****/status" \
    -H "Authorization: Bearer sk-VStOhW7gwGTcy5lFuDg*****" \
    -H "Content-Type: application/json"'
  2. 响应参数。

    {
    "code": 0,
    "message": "查询成功",
    "data": [
    {
    "taskId": "1bbd090349684776b1c39bfca1c*****",
    "status": "PROCESSING",
    }
    ],
    "ts": "2026-01-12T15:26:02.792426286+08:00[Asia/Shanghai]"
    }

    其中"status"参数的取值包括:

    • PENDING:排队中
    • PROCESSING:生成中
    • COMPLETED:已完成
    • FAILED:已失败
    • CANCELED:用户主动取消
    • UNKNOWN:未知,对于taskId不存在时返回此状态

查询任务生成结果

  1. 请求参数。

    curl --location --request GET 'https://cloud.baicaiinfer.com/v1/comfyui/tasks/144dd5eb9fe84eeda17624483f6*****/result'\
    -H "Authorization: Bearer sk-VStOhW7gwGTcy5lFuDg*****" \
    -H "Content-Type: application/json"'
  2. 响应参数。

    {
    "code": 0,
    "message": "查询成功",
    "data": [
    {
    "taskId": "144dd5eb9fe84eeda17624483f6*****",
    "status": "COMPLETED",
    "progress": "已完成",
    "result": {
    "urls": [
    "https://s1.llamafactory.online/baicai-infer/results/1bbd090349684776b1c39bfca1c*****/ComfyUI_00666_.png"
    ]
    }
    }
    ],
    "ts": "2026-01-12T15:26:12.146157857+08:00[Asia/Shanghai]"
    }

    其中"status"参数和"progress"参数的取值是一一对应的,取值包括:

    • PENDING:排队中
    • PROCESSING:生成中
    • COMPLETED:已完成
    • FAILED:已失败
    • CANCELED:用户主动取消
    • UNKNOWN:未知,对于taskId不存在时返回此状态

取消任务

  1. 请求参数。

    curl --location --request DELETE 'https://cloud.baicaiinfer.com/v1/comfyui/tasks/{taskId}'
  2. 响应参数。

    {
    "code": 0,
    "message": "success",
    "data": null
    }

查看费用账单

  1. 登录Baicai Infer平台。

  2. 单击页面右上方的头像图标(如图①),然后在下拉列表单击「费用中心」(如图②),进入费用中心页面。

    账户充值界面

  3. 在左侧导航栏单击「账单明细 > Baicai Infer」,其中「任务类型」选择「API调用」,即可查看其账单明细。

    您还可根据“消费时段、“消费方式”等筛选账单明细,也可根据“API Key名称”和“API key”精准查找账单明细。