用量查询
POST/jobs

创建浮雕任务

浮雕任务基础标价为 standard 30 点、pro 50 点。符合条件的线条先加 10 标价点再计算百分比合同折扣;固定价合同加 10 点。图片上传另扣 1 点。队列拒绝或生成最终失败时退还生成扣点;浮雕成功但未交付 DXF 时退还实际线条加价。未提供 Idempotency-Key 时,重复提交是新的计费任务。

算力消耗

30 / 50 (+10 optional) 算力点
API 标价:30 / 50 (+10 optional) 算力点 · 动态计费

分层计费时,已享充值优惠的算力包优先按原规则消费;合同包按绑定合同计价,实际扣点以调用结果为准。

代码示例

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
}'

请求参数

source.file_idstring必填
示例: file_...

POST /files 上传成功后返回、且属于当前 API 账户的文件 ID。

  • 上传是独立操作,仅上传成功时扣 1 点。
  • 同一个属于你的 file_id 可以创建多个任务,复用文件不会再次收取上传费。
  • 文件不存在、属于其他账户或上传尚未成功时,任务会在生成扣费前被拒绝。
tierstandard | pro可选
默认: standard示例: standard

浮雕基础标价:standard 30 API 点,pro 50 API 点。符合条件的线条先加 10 标价点,再按 API 合同折扣计价;固定价合同在固定价上加 10 点。网站会员折扣不适用于 API。

standard基础版,任务接受时扣 30 API 点。
pro高级版,任务接受时扣 50 API 点。
relief_typeshallow | deep可选
默认: shallow示例: shallow

描述成品最高点与最低点的预期高度差,默认 shallow;不会改变价格。

shallow浅浮雕,适合文字、徽章、薄牌和精细小件。
deep深浮雕,适合人物、动物、雕塑和更强体积感。
  • shallow(浅浮雕):适合精细花纹、文字、纪念币、徽章、薄牌、珠宝细节和小尺寸精密加工;常见产品参考高度约 0.5~2 mm。
  • deep(深浮雕):适合人物、动物、神像、雕塑和需要更强体积感的大型浮雕;常见产品参考高度约 2~8 mm。
  • 应按期望成品的实际高低差选择,不要仅根据源图是线稿还是照片判断。
relief_settingsobject可选
默认: 可不填示例: {"mode":"preset","preset":"medium"}

可选参数,基础和高级均支持;不传时保留原有调用和返回格式,价格不变。不能同时传 relief_type。

  • 预设:mode=preset, preset=medium;preset 可选 shallow、medium、deep,与对应行业的网页三档一致。
  • 自定义:mode=custom, longest_side_mm=100, height_mm=8.1。长边 10~1000 mm,高低差 0.5~100 mm,支持小数。E=高低差×100÷长边,以 2/4/8 为固定分界,等于边界时留在前一档;通用(style=general)四档,其他行业各自三档。
  • 烫金和刺绣场景继续用原请求,不传此对象。新任务回显 relief_settings,relief_type 为所选预设或 custom。
  • 显式 custom 请求的 VSM 按填写的毫米尺寸导出:平面保留结果图比例,非平坦高低差缩放到 height_mm;平图保持零高度。原有调用与 preset 的 VSM 仍用默认导出设置。
stylestring可选
默认: general示例: general可选: 见下方风格列表

可选的生成风格,默认 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 的客户。 显式 custom 请求的 VSM 按填写的毫米尺寸导出:平面保留结果图比例,非平坦高低差缩放到 height_mm;平图保持零高度。原有调用与 preset 的 VSM 仍用默认导出设置。
  • tif:更适合后续浮雕、深度图和生产加工流程,建议生产用途优先选择。
  • png:便于快速预览,也更容易被常见图片软件直接打开。
  • vsm:从无水印 TIF 按默认导出参数生成,不应用网页编辑器里的高度、反相、平滑、背景阈值或曲线等手动调整。
  • 任务成功后可能还会返回其他可用产物;该参数选择主要请求格式。
  • 显式 custom 请求的 VSM 按填写的毫米尺寸导出:平面保留结果图比例,非平坦高低差缩放到 height_mm;平图保持零高度。原有调用与 preset 的 VSM 仍用默认导出设置。
model_weightnumber 0..1可选
默认: 0.5示例: 0.5可选: 0 到 1

控制模型对结果的影响强度,范围 0~1,默认 0.5;不会改变价格。

  • 较低数值通常更偏向保留源图结构,转换更保守。
  • 较高数值会增强所选模型/风格的影响,可能更明显地重塑细节。
  • 建议先用 0.5,对比结果后逐步调整;数值越高不代表质量一定越好。
reliefCenterlineOutputboolean可选
默认: false示例: true可选: true, false

可选,默认 false。符合条件的 pro 任务设为 true 后生成可编辑线条 DXF。先加 10 标价点再计算百分比合同折扣;固定价合同加 10 点。HotStampingThinCharacters、HotStampingThickCharacters、EmbroideryTexture 不支持。从任务产物获取 DXF;浮雕成功但未交付 DXF 时退还实际线条加价一次。

Idempotency-Keyheader可选
默认: 可不填示例: relief-request-001

可选的安全重试键;不提供时,每次重复提交都会被视为新的可计费请求。

  • 只提交一次且不自动重试时可以不填。超时或网络中断后,应为完全相同的请求复用同一个稳定唯一键,避免重复扣费。
  • 同一个键不能用于不同参数;换一个新键会创建新请求并再次扣费。

响应示例

200application/json
{
  "id": "api_...",
  "object": "relief_job",
  "status": "queued",
  "tier": "standard",
  "points": 30,
  "progress": 0,
  "artifacts": []
}
关注我们
抖音小红书快手哔哩哔哩今日头条
© 2024 杭州仓颉造梦数字科技有限公司

浙ICP备2024069408号-1

浙公网安备33011302001161号