file_...POST /files 上传成功后返回、且属于当前 API 账户的文件 ID。
- 上传是独立操作,仅上传成功时扣 1 点。
- 同一个属于你的 file_id 可以创建多个任务,复用文件不会再次收取上传费。
- 文件不存在、属于其他账户或上传尚未成功时,任务会在生成扣费前被拒绝。
/jobs浮雕任务基础标价为 standard 30 点、pro 50 点。符合条件的线条先加 10 标价点再计算百分比合同折扣;固定价合同加 10 点。图片上传另扣 1 点。队列拒绝或生成最终失败时退还生成扣点;浮雕成功但未交付 DXF 时退还实际线条加价。未提供 Idempotency-Key 时,重复提交是新的计费任务。
分层计费时,已享充值优惠的算力包优先按原规则消费;合同包按绑定合同计价,实际扣点以调用结果为准。
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
}'file_...POST /files 上传成功后返回、且属于当前 API 账户的文件 ID。
standard示例: standard浮雕基础标价:standard 30 API 点,pro 50 API 点。符合条件的线条先加 10 标价点,再按 API 合同折扣计价;固定价合同在固定价上加 10 点。网站会员折扣不适用于 API。
standard基础版,任务接受时扣 30 API 点。pro高级版,任务接受时扣 50 API 点。shallow示例: shallow描述成品最高点与最低点的预期高度差,默认 shallow;不会改变价格。
shallow浅浮雕,适合文字、徽章、薄牌和精细小件。deep深浮雕,适合人物、动物、雕塑和更强体积感。可不填示例: {"mode":"preset","preset":"medium"}可选参数,基础和高级均支持;不传时保留原有调用和返回格式,价格不变。不能同时传 relief_type。
general示例: general可选: 见下方风格列表可选的生成风格,默认 general;它不是自由输入的提示词,也不会改变价格。
general通用适合大多数普通图片和首次接入;不确定时优先使用。JewelryMoldsUniversal通用首饰模具适合常规首饰模具和浮雕挂件。JewelryMoldsCommemorativeCoin纪念币/徽章适合纪念币、徽章、奖牌和圆形精细浮雕。JewelryMoldsBracelet手镯/戒面适合手镯、戒面和弧面珠宝细节。HotStampingBulgingUniversal烫金凸起适合主体结构清晰的凸起烫金效果。HotStampingThickCharacters烫金粗字纹理适合较粗文字、厚重笔画和更强浮雕感。HotStampingThinCharacters烫金细字纹理适合细线条、小字和精细烫金纹理。EmbroideryTexture刺绣纹理适合织物、针脚和刺绣质感表达。StoneCarvingUniversal通用石雕适合通用石雕和清晰纹理贴图。StoneCarvingLongChart石雕长图适合石雕长图、复杂构图和连续图案。StoneCarvingYangHua石雕洋花适合欧式洋花、装饰纹样和石雕花边。WoodCarvingUniversal通用木雕适合通用木雕和清晰纹理贴图。WoodCarvingLongChart木雕长图适合木雕长图、复杂构图和连续图案。WoodCarvingYangHua木雕洋花适合欧式洋花、装饰纹样和木雕花边。JadeMoldsUniversal通用玉雕适合通用玉雕模具和高清纹理贴图。JadeMoldsPendant玉雕挂件适合挂件、牌子、玉牌和吊坠类玉雕。JadeMoldsBrand玉雕牌子适合玉牌、平面牌型和牌子类浮雕。CopperAluminumUniversal通用铜铝雕适合通用铜雕、铝雕和金属浮雕。CopperAluminumLighter打火机雕刻适合打火机表面雕刻和装饰纹理。CopperAluminumEngraving金属精雕适合铜铝等金属表面的精细雕刻。remove示例: remove控制源图背景是否参与浮雕生成,默认 remove;不会改变价格。
remove去除或黑化背景,让主体成为浮雕重点。keep保留背景结构,适合完整场景、壁画、山水和底纹。tif示例: tif选择主要浮雕产物格式,默认 tif;不会改变价格。
tif生产加工、深度图和后续处理优先选择。png适合快速预览,常见图片软件更容易打开。vsm从无水印 TIF 按默认导出参数生成,适合需要直接下载 VSM 的客户。 显式 custom 请求的 VSM 按填写的毫米尺寸导出:平面保留结果图比例,非平坦高低差缩放到 height_mm;平图保持零高度。原有调用与 preset 的 VSM 仍用默认导出设置。0.5示例: 0.5可选: 0 到 1控制模型对结果的影响强度,范围 0~1,默认 0.5;不会改变价格。
false示例: true可选: true, false可选,默认 false。符合条件的 pro 任务设为 true 后生成可编辑线条 DXF。先加 10 标价点再计算百分比合同折扣;固定价合同加 10 点。HotStampingThinCharacters、HotStampingThickCharacters、EmbroideryTexture 不支持。从任务产物获取 DXF;浮雕成功但未交付 DXF 时退还实际线条加价一次。
可不填示例: relief-request-001可选的安全重试键;不提供时,每次重复提交都会被视为新的可计费请求。
{
"id": "api_...",
"object": "relief_job",
"status": "queued",
"tier": "standard",
"points": 30,
"progress": 0,
"artifacts": []
}