模型
生图配图怎么用
下载 Markdown先 POST /v1/files 拿凭证并上传,再 generate 带 fileIds。
配图不是第三种模型。它是同一 kind=image 渠道,加上参考图。渠道 ID 与 生图 相同。
顺序:拿直传凭证 → 把字节 POST 到上传地址 → POST /v1/images/generate 带 fileIds。
export BASE=https://www.dexbuddy.app
export DEX_API_KEY='dbh_sk_…'
# 1. 凭证。contentLength 是参考图字节数
curl -sS "$BASE/v1/files" \
-H "Authorization: Bearer $DEX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contentType":"image/png","contentLength":12345}'
# 响应含 id、key、uploadUrl、token
# 2. 直传字节,不经网关
curl -sS "$UPLOAD_URL" \
-F "token=$TOKEN" \
-F "key=$KEY" \
-F "file=@ref.png;type=image/png"
# 3. 生图。fileIds 用第 1 步的 id
curl -sS "$BASE/v1/images/generate" \
-H "Authorization: Bearer $DEX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "image-standard",
"prompt": "保持构图,改成黄昏",
"fileIds": ["FILE_ID"]
}'POST /v1/files 免费,不预留积分。成功字段:id、key、uploadUrl、token、expiresAt。
配额错误
不要绕过。停在文档给出的码:
| code | 含义 |
|---|---|
FILE_QUOTA | 未过期参考图数量已达上限 |
FILE_NOT_USABLE | 参考图不可用(不存在、已过期或非本人) |
其它错误体是 { ok: false, code, error }。
插件侧
页面不要 fetch 网关。index.js 里:
await models.images.generate({
model: 'image-standard',
input: {
prompt,
input_images: ['/绝对路径/ref.png'],
},
outputPath: '/绝对路径/out.png',
});input_images 是本机绝对路径,宿主代传。返回 { status, output, model },output 是本地路径。详见 插件开发 → 模型。