source.file_idstring必填
示例:
file_...POST /files 上传成功后返回、且属于当前 API 账户的文件 ID。
- 上传是独立操作，仅上传成功时扣 1 点。
- 同一个属于你的 file_id 可以创建多个任务，复用文件不会再次收取上传费。
- 文件不存在、属于其他账户或上传尚未成功时，任务会在生成扣费前被拒绝。
POST
/jobs创建浮雕任务
参数校验通过且任务被接受时扣费：standard 固定扣 30 API 点，pro 固定扣 50 API 点；上传文件另扣 1 点，其他浮雕参数不改变价格。队列拒绝或生成最终失败会退回本次生成扣点；未显式提供 Idempotency-Key 时，重复提交会作为新任务再次扣费。
算力消耗
30 / 50 算力点
调用该接口消耗 30 / 50 算力点 · 动态计费
代码示例
curl --request POST \
--url 'https://www.cjzmai.com/v2/jobs' \
--header 'Authorization: Bearer sk-your-api-key' \
--header 'Content-Type: application/json' \
--data '{
"source": {
"file_id": "file_..."
},
"tier": "standard",
"relief_type": "shallow",
"style": "general",
"background_mode": "remove",
"output_format": "tif",
"model_weight": 0.5
}'请求参数
tierstandard | pro可选
默认:
standard示例: standard浮雕任务中唯一决定生成价格和处理档位的参数，默认 standard。
standard基础版，任务接受时扣 30 API 点。pro高级版，任务接受时扣 50 API 点。- standard：基础版；任务通过校验并被接受时固定扣 30 API 点。
- pro：高级版；任务通过校验并被接受时固定扣 50 API 点。
- 这是固定 API 价格，其他浮雕参数不会改变本次生成价格。
- API 使用固定价格，不享受网站会员、企业版或经销商折扣。
relief_typeshallow | deep可选
默认:
shallow示例: shallow描述成品最高点与最低点的预期高度差，默认 shallow；不会改变价格。
shallow浅浮雕，适合文字、徽章、薄牌和精细小件。deep深浮雕，适合人物、动物、雕塑和更强体积感。- shallow（浅浮雕）：适合精细花纹、文字、纪念币、徽章、薄牌、珠宝细节和小尺寸精密加工；常见产品参考高度约 0.5～2 mm。
- deep（深浮雕）：适合人物、动物、神像、雕塑和需要更强体积感的大型浮雕；常见产品参考高度约 2～8 mm。
- 应按期望成品的实际高低差选择，不要仅根据源图是线稿还是照片判断。
stylestring可选
默认:
general示例: general可选: 见下方 style 列表可选的生成风格，默认 general；它不是自由输入的提示词，也不会改变价格。
general通用适合大多数普通图片和首次接入；不确定时优先使用。JewelryMoldsUniversal通用首饰模具适合常规首饰模具和浮雕挂件。JewelryMoldsCommemorativeCoin纪念币/徽章适合纪念币、徽章、奖牌和圆形精细浮雕。JewelryMoldsBracelet手镯/戒面适合手镯、戒面和弧面珠宝细节。HotStampingBulgingUniversal烫金凸起适合主体结构清晰的凸起烫金效果。HotStampingThickCharacters烫金粗字纹理适合较粗文字、厚重笔画和更强浮雕感。HotStampingThinCharacters烫金细字纹理适合细线条、小字和精细烫金纹理。EmbroideryTexture刺绣纹理适合织物、针脚和刺绣质感表达。StoneCarvingUniversal通用石雕适合通用石雕和清晰纹理贴图。StoneCarvingLongChart石雕长图适合石雕长图、复杂构图和连续图案。StoneCarvingYangHua石雕洋花适合欧式洋花、装饰纹样和石雕花边。WoodCarvingUniversal通用木雕适合通用木雕和清晰纹理贴图。WoodCarvingLongChart木雕长图适合木雕长图、复杂构图和连续图案。WoodCarvingYangHua木雕洋花适合欧式洋花、装饰纹样和木雕花边。JadeMoldsUniversal通用玉雕适合通用玉雕模具和高清纹理贴图。JadeMoldsPendant玉雕挂件适合挂件、牌子、玉牌和吊坠类玉雕。JadeMoldsBrand玉雕牌子适合玉牌、平面牌型和牌子类浮雕。CopperAluminumUniversal通用铜铝雕适合通用铜雕、铝雕和金属浮雕。CopperAluminumLighter打火机雕刻适合打火机表面雕刻和装饰纹理。CopperAluminumEngraving金属精雕适合铜铝等金属表面的精细雕刻。- general：通用浮雕风格，适合大多数普通图片；不确定如何选择时优先使用它。
- 不填写 style 时，系统会自动使用 general。
- 只有当其他取值出现在当前公开文档中，或官方明确告知该取值可公开使用时，才应填写其他值。
background_moderemove | keep可选
默认:
remove示例: remove控制源图背景是否参与浮雕生成，默认 remove；不会改变价格。
remove去除或黑化背景，让主体成为浮雕重点。keep保留背景结构，适合完整场景、壁画、山水和底纹。- remove：去除或黑化源图背景，让主体成为浮雕重点；纯色或简单背景通常效果更稳定。
- keep：保留背景结构并让其参与高度图生成；适合完整场景、壁画、山水和带底纹的栏板。
output_formatpng | tif | vsm可选
默认:
tif示例: tif选择主要浮雕产物格式，默认 tif；不会改变价格。
tif生产加工、深度图和后续处理优先选择。png适合快速预览，常见图片软件更容易打开。vsm从无水印 TIF 按默认导出参数生成，适合需要直接下载 VSM 的客户。- tif：更适合后续浮雕、深度图和生产加工流程，建议生产用途优先选择。
- png：便于快速预览，也更容易被常见图片软件直接打开。
- vsm：从无水印 TIF 按默认导出参数生成，不应用网页编辑器里的高度、反相、平滑、背景阈值或曲线等手动调整。
- 任务成功后可能还会返回其他可用产物；该参数选择主要请求格式。
model_weightnumber 0..1可选
默认:
0.5示例: 0.5可选: 0 到 1控制模型对结果的影响强度，范围 0～1，默认 0.5；不会改变价格。
- 较低数值通常更偏向保留源图结构，转换更保守。
- 较高数值会增强所选模型/风格的影响，可能更明显地重塑细节。
- 建议先用 0.5，对比结果后逐步调整；数值越高不代表质量一定越好。
Idempotency-Keyheader可选
默认:
可不填示例: relief-request-001可选的安全重试键；不提供时，每次重复提交都会被视为新的可计费请求。
- 只提交一次且不自动重试的普通调用可以不填。
- 如果超时或网络中断后可能重发完全相同的请求，应由客户端生成一个稳定唯一值，并在该次重试中复用。
- 同一个键不能用于不同参数；换一个新键会创建新任务并再次扣费。
响应示例
200application/json
{
"id": "api_...",
"object": "relief_job",
"status": "queued",
"tier": "standard",
"points": 30,
"progress": 0,
"artifacts": []
}