电商文生图 API

基于 Stable Diffusion 的电商图像生成服务

v2.0 - 已启用 API Key 鉴权
🔐 当前模式: API Key 鉴权  |  Base URL: https://api.ai-baidu.com/api/

🔑 API Key 鉴权

所有接口(除根路径)都必须带上 X-API-Key 请求头。

Key 格式

如何传递

在 HTTP 请求头中添加:

Headers:
  Content-Type: application/json
  X-API-Key: bd-a8d07ce05c54cd6e135ca90629a76e72

获取 Key

联系管理员生成。每个 Key 可以随时启用/禁用,便于管理。

演示 Key(仅供测试)

演示 Key:
bd-demo1234567890abcdef1234567890ab
⚠️ 演示 Key 仅用于测试,生产环境请联系管理员分配专属 Key。

鉴权错误码

HTTP状态码错误类型说明解决方案
401missing_api_key没有带 X-API-Key在请求头加上 X-API-Key
401invalid_key_formatKey 不是 bd- 开头检查 Key 格式
403invalid_api_keyKey 不存在或被禁用联系管理员重新生成
200-调用成功-

快速开始(带 Key)

Python

import requests

API_KEY = "bd-a8d07ce05c54cd6e135ca90629a76e72"  # 替换成你的Key

response = requests.post(
    "https://api.ai-baidu.com/api/text2img",
    headers={"X-API-Key": API_KEY},
    json={
        "prompt": "premium gift box, wooden table, warm lighting",
        "style": "product_photo"
    }
)
data = response.json()

import base64
with "output.png", "wb") as f:
    f.write(base64.b64decode(data["image"]))

JavaScript

const API_KEY = "bd-a8d07ce05c54cd6e135ca90629a76e72";

const response = await fetch("https://api.ai-baidu.com/api/text2img", {
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        "X-API-Key": API_KEY
    },
    body: JSON.stringify({
        prompt: "luxury gift box",
        style: "product_photo"
    })
});
const data = await response.json();

cURL

curl -X POST https://api.ai-baidu.com/api/text2img \
  -H "Content-Type: application/json" \
  -H "X-API-Key: bd-a8d07ce05c54cd6e135ca90629a76e72" \
  -d '{"prompt":"gift box","style":"product_photo"}'

接口列表(均需鉴权)

POST /api/text2img

文生图:根据文字描述生成图片

字段类型必填说明
promptstring必填图片描述,30-200字效果最佳
stylestring可选product_photo | lifestyle | festive
widthinteger可选宽度 512-2048,默认1024
heightinteger可选高度 512-2048,默认1024
POST /api/img2img

图改图:基于原图生成新版本

字段位置必填说明
imageform-data必填原图文件
promptquery必填目标效果描述
strengthquery可选修改强度 0-1,默认0.7
stylequery可选风格
POST /api/inpaint

局部重绘:用蒙版标记区域重绘

字段位置必填说明
imageform-data必填原图
maskform-data必填蒙版(白色=重绘区域)
promptquery必填重绘内容描述
stylequery可选风格
GET /api/history

查看历史生成记录

GET /api/stats

系统统计

功能特性

文生图

支持3种风格预设:产品摄影、生活方式、节日氛围

图改图

上传原图+描述,生成优化版本

局部重绘

用蒙版标记区域,精准修改

持续学习

每次生成的样本自动保存

API Key管理

每个Key可独立启用/禁用

使用统计

记录每个Key的调用次数

风格预设

style中文名适用场景
product_photo产品摄影电商主图、商品详情、白底图
lifestyle生活方式使用场景图、生活化氛围
festive节日氛围节庆、促销、礼盒场景

Prompt 撰写技巧

推荐结构

[主体描述] + [材质质感] + [光线氛围] + [构图角度] + [质量标签]

实用例子

产品摄影

"premium gift box with red ribbon, matte finish, wooden table,
studio lighting with soft shadows, eye-level angle, shot on Canon EOS R5,
8k, high detail, professional product photography"

生活方式

"fresh bamboo leaves arranged on kitchen counter, morning sunlight
streaming through window, bokeh background, cozy atmosphere, shot from
above, lifestyle photography, natural colors"
提示:写英文 prompt 通常效果更稳定。如果对英文不熟,可以先用中文想清楚要表达的画面,再翻译成简单词组。

限制与计费

当前限制
请求频率无限制(测试模式)
图片尺寸512 - 2048 像素
文件上传最大 10MB
Prompt 长度建议 30-500 字
当前为测试模式,生成的图片为占位示例。正式生产环境需要配置云端API密钥。

在线测试

所有接口支持 Swagger 交互式文档测试(需带 Key):

打开 Swagger 文档

在Swagger页面右上角点击"Authorize"按钮,输入你的 API Key 即可测试。