用量查询
POST/design/jobs

创建 AI 设计任务

使用自定义提示词或公开 AI 设计场景 mode。预设 mode 使用官方场景提示词,只有 custom 使用你自己填写的自由提示词;1K/2K/4K 固定消耗 15/20/30 API 点。

算力消耗

15 / 20 / 30 算力点
调用该接口消耗 15 / 20 / 30 算力点 · 动态计费

代码示例

curl --request POST \
  --url 'https://www.cjzmai.com/v2/design/jobs' \
  --header 'Authorization: Bearer sk-your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "mode": "product_photography",
  "source": {
    "file_id": "file_..."
  },
  "resolution": "1k"
}'

请求参数

modecustom | public scene mode id必填
示例: product_photography可选: custom 或下方场景列表

公开英文 mode id。custom 使用你自己填写的 prompt;其他预设 mode 对应网站 AI 图片编辑里的固定官方场景。

  • 可通过 GET /capabilities 或下方场景列表查看稳定取值。
  • 预设 mode 不是自由提示词,也不会开启自动场景判断。
  • 例如 material_gold 表示黄金材质场景,pvc_render 表示 PVC 材质渲染场景。
promptstring可选
默认: 非 custom 可不填示例: Make the product photo cleaner and brighter

仅当 mode=custom 时必填。预设 mode 使用官方场景提示词,不把该字段当作主提示词。

  • custom 模式下,请清楚描述希望得到的图片编辑结果。
  • 预设模式下应选择 mode id,不需要也不应该复制网站内部提示词。
source.file_idstring可选
示例: file_...

POST /files 返回的文件 ID。预设 mode 必填;custom 通常也会使用源图。

  • 文件必须属于当前 API 账户。
  • 上传成功只扣 1 点;重复使用同一个属于你的 file_id 不会再次收上传费。
second_source.file_idstring可选
默认: 可不填示例: file_...

可选第二张参考图,仅对支持双图输入的场景有意义;材质类 mode 会忽略第二张图。

resolution1k | 2k | 4k可选
默认: 1k示例: 1k

输出分辨率,也是 AI 设计唯一决定价格的参数:1k=15 点,2k=20 点,4k=30 点。

aspect_ratioauto | 1:1 | 2:3 | 3:4 | 4:5 | 5:4 | 4:3 | 3:2 | 9:16 | 16:9 | 21:9可选
默认: auto示例: 1:1

期望输出比例。four_view_sheet 会固定为 1:1,便于生成整齐四视图。

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

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

AI Design

AI 设计场景模式

预设 mode 对应网站「AI 图片编辑」里的固定场景。接口里填写英文 mode id,服务端会使用该场景的官方提示词;只有 custom 模式才使用你自己写的自由提示词。

custom 需要填写 prompt;其他预设场景需要填写 source.file_id,并从下面选择 mode。

自定义 AI 设计

不使用固定场景时,用自由提示词完成图片设计。

自定义AI设计
custom自定义AI设计

自己编写 prompt,可上传一张或两张参考图。

文创IP

PVC、3D 概念、四视图、冰箱贴、IP 形象和产品摄影类场景。

图片转3D素模效果
image_to_3d_concept图片转3D素模效果

把普通图片转成干净的 3D 素模效果图。

图片转PVC材质渲染图
pvc_render图片转PVC材质渲染图

把主体渲染成 PVC 文创产品效果。

线稿转PVC材质渲染图
line_art_to_pvc线稿转PVC材质渲染图

把线稿转成 PVC 材质上色渲染图。

图转4视图
four_view_sheet图转4视图

生成正面、侧面、背面等四视图参考。

图片转冰箱贴设计
fridge_magnet_design图片转冰箱贴设计

把图片设计成冰箱贴文创产品。

图片转IP形象设计
ip_character_design图片转IP形象设计

根据源图生成 IP 形象设计方向。

产品摄影
product_photography产品摄影

生成干净的商业产品展示图。

修图工具

图像矫正、修复、线稿提取、去背景和图案提取。

图像矫正
perspective_correction图像矫正

修正歪斜、透视不正的源图。

图像修复
image_restore图像修复

修复破损、老照片或低质量图片。

文物修复
artifact_restore文物修复

修复文物类图片并保留历史质感。

提取线稿
line_art_extraction提取线稿

从参考图中提取干净线稿。

提取图案
pattern_extraction提取图案

提取可复用的装饰图案。

去除背景
background_removal去除背景

去除图片背景,便于产品图或设计复用。

图片二创
creative_variation图片二创

基于源图生成新的二创方案。

珠宝模具

珠宝草图渲染、饰品设计、二创、精修、摄影和材质渲染。

珠宝材质渲染
material_gold珠宝材质渲染

将珠宝或小件产品渲染成指定金属材质。

同类材质 mode
material_goldmaterial_silvermaterial_copper
珠宝草图渲染
jewelry_sketch_render珠宝草图渲染

把珠宝草图转成精致渲染预览。

图片转珠宝饰品设计
jewelry_design图片转珠宝饰品设计

根据参考图生成珠宝饰品设计。

珠宝产品二创
jewelry_variation珠宝产品二创

生成珠宝产品二创方案。

珠宝产品精修
jewelry_retouch珠宝产品精修

精修珠宝产品图,提升展示质感。

图片转珠宝摄影图
jewelry_photography图片转珠宝摄影图

生成珠宝摄影风格产品图。

烫金包装

击凸、烫金浮雕、文字纹理、包装盒效果和刀模转换。

击凸
paper_emboss击凸

生成纸张击凸效果。

图片转烫金浮雕效果
hot_foil_relief图片转烫金浮雕效果

把图片转成烫金浮雕效果。

文字生成纹理效果
text_texture文字生成纹理效果

根据文字或标识结构生成纹理效果。

图片转包装盒效果图
packaging_mockup图片转包装盒效果图

生成包装盒成品效果图。

刀模图转成品包装盒效果图
dieline_to_packaging刀模图转成品包装盒效果图

把刀模图转成包装盒成品效果。

包装盒转刀模展开图
packaging_to_dieline包装盒转刀模展开图

把包装盒效果图转成刀模展开图。

玉雕

玉石手稿、玉雕成品、场景摄影和玉石材质模式。

玉石手稿
jade_manuscript玉石手稿

生成玉石手稿设计。

玉石手稿转玉雕成品效果图
jade_manuscript_to_carving玉石手稿转玉雕成品效果图

把玉石手稿转成玉雕成品效果图。

图片转玉雕作品设计
jade_carving_design图片转玉雕作品设计

根据图片生成玉雕作品设计。

玉雕成品场景摄影图
jade_carving_photography玉雕成品场景摄影图

生成玉雕成品场景摄影图。

玉雕材质渲染
material_icy_jadeite玉雕材质渲染

将源图渲染成指定玉石材质。

同类材质 mode
material_icy_jadeitematerial_glutinous_jadeitematerial_white_jadematerial_dark_green_jadematerial_yellow_jadematerial_black_jade

石雕

石雕材质渲染和石雕成品场景摄影。

石雕材质渲染
material_marble石雕材质渲染

将源图渲染成指定石材质。

同类材质 mode
material_marblematerial_granitematerial_terrazzomaterial_sandstonematerial_qingtian_stonematerial_white_marble
石雕成品场景摄影图
stone_carving_photography石雕成品场景摄影图

生成石雕成品场景摄影图。

木雕

木雕材质渲染和木雕成品场景摄影。

木雕材质渲染
material_rosewood木雕材质渲染

将源图渲染成指定木材质。

同类材质 mode
material_rosewoodmaterial_nanmumaterial_teakmaterial_sandalwoodmaterial_basswoodmaterial_pine
木雕成品场景摄影图
wood_carving_photography木雕成品场景摄影图

生成木雕成品场景摄影图。

铜铝雕

金属材质渲染、铝雕门和打火机浮雕效果。

铜铝雕材质渲染
material_aluminum铜铝雕材质渲染

将源图渲染成铝合金、红铜、黄铜或青古铜材质。

同类材质 mode
material_aluminummaterial_red_coppermaterial_brassmaterial_antique_bronze
图片转铝雕门效果图
aluminum_door_relief图片转铝雕门效果图

把图片转成铝雕门效果图。

图片转浮雕打火机效果图
lighter_relief图片转浮雕打火机效果图

生成打火机表面浮雕效果图。

其他稳定模式

已开放但当前网站卡片里没有独立封面的稳定模式。

图像拆分
component_breakdown图像拆分

将源图拆分成更清晰的视觉部件。

转2D插画
illustration_2d转2D插画

把源图转成 2D 插画风格。

响应示例

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

浙ICP备2024069408号-1

浙公网安备33011302001161号