跳到主要内容

快速调用示例

更新时间: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]"
    }

发起「旅拍vlog」任务

  1. 请求参数。

    curl --location --request POST 'https://cloud.baicaiinfer.com/v1/comfyui/create' \
    -H 'Authorization: Bearer sk-VCanjKeXkla7UHUvdmw*****' \ //已获取的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"
    }
    },
    "appDisplayParams":"{
    \"source_image1\":{\"filename\":\"7e4113a5a1284465831eaefaa0022a98/fmJHcc-travel_memories.jpg\",\"fullPath\":\"https://s1.llamafactory.online/baicai-infer/users/7e4113a5a1284465831eaefaa0022a98/fmJHcc-travel_memories.jpg/\",\"id\":\"guanyuaudio\",\"message\":\"文件上传成功\",\"path\":\"/root/ComfyUI/input/7e4113a5a1284465831eaefaa0022a98/fmJHcc-travel_memories.jpg\",\"type\":\"file\"}
    }",
    "workflowId":"travel_memories"
    }

    此处的"filename"、"fullPath"以及 "path"参数值,应与「上传文件」接口返回的响应值一一对应。

    提示

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

  2. 响应参数。

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

查询任务状态

  1. 请求参数。

    curl --location --request GET 'https://cloud.baicaiinfer.com/v1/comfyui/tasks/status'
  2. 响应参数。

    {
    "code": 0,
    "message": "success",
    "data": {
    "status": "COMPLETED",
    "taskId": "55962a3b613349de9cd9da4f0f1*****"
    },
    "ts": "2025-12-23T11:23:28.358794062+08:00[Asia/Shanghai]"
    }

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

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

查询任务生成结果

  1. 请求参数。

    curl --location --request GET 'https://cloud.baicaiinfer.com/v1/comfyui/tasks/result'
  2. 响应参数。

    {
    "code": 0,
    "message": "success",
    "data": {
    "taskId": "55962a3b613349de9cd9da4f0f1*****",
    "status": "COMPLETED",
    "result": {
    "image_urls": [
    "https://llamafactory-online-assets.oss-cn-beijing.aliyuncs.com/results/55962a3b613349de9cd9da4f0f1*****/ComfyUI_00165_.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=LTAI5tPZnVrTYKWA9yTdZFDx%2F20251029%2Fbeijing%2Fs3%2Faws4_request&X-Amz-Date=20251029T071747Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&X-Amz-Signature=15b0fd8009cfb6c0964a8de7f293c8c3ed4f87a1d65040030ec310*******"
    ]
    }
    },
    "ts": "2025-12-22T11:33:28.358794062+08:00[Asia/Shanghai]"
    }

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

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

取消任务

  1. 请求参数。

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

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

查看费用账单

  1. 登录Baicai Infer平台。

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

    账户充值界面

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

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