POST/model/jobs

创建圆雕 3D 任务

仅开放三种模型生成模式，API 用户不享受网站会员折扣。

算力消耗

50–100 算力点

调用该接口消耗 50–100 算力点 · 动态计费

代码示例

curl --request POST \
  --url 'https://www.cjzmai.com/v2/model/jobs' \
  --header 'Authorization: Bearer sk-your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "image_to_model",
  "source": {
    "file_id": "file_..."
  },
  "quality": "basic",
  "texture": false,
  "pbr": false
}'

请求参数

typetext_to_model | image_to_model | multiview_to_model必填

示例: image_to_model

选择 3D 生成方式：文字生成、单图生成或多视图生成。

text_to_model文生 3D。只提交文字描述，必须填写 prompt。

image_to_model图生 3D。先上传一张图片，再填写 source.file_id。

multiview_to_model多视图生成 3D。必须提供 front，并至少再提供 left/back/right 其中一张。

text_to_model：文生 3D，只需要文字描述，必须填写 prompt。
image_to_model：图生 3D，先上传一张图片，然后填写 source.file_id。
multiview_to_model：多视图生成 3D，需要正面图 views.front.file_id，并至少再提供 left/back/right 其中一张。

promptstring可选

默认: 仅文生 3D 需要示例: A cute cat wearing a spacesuit

仅当 type=text_to_model 时必填。用自然语言描述要生成的 3D 模型。

最大长度 2000 个字符。
image_to_model 或 multiview_to_model 当前不需要填写 prompt，除非后续公开文档明确说明支持。

source.file_idstring可选

示例: file_...

仅当 type=image_to_model 时必填。填写 POST /files 上传成功后返回的文件 ID。

文件必须属于当前 API 账户。
上传图片是独立操作，上传成功扣 1 点；复用同一个属于你的 file_id 不会重复收上传费。

views.front.file_idstring可选

示例: file_front...

仅当 type=multiview_to_model 时必填。这里填写正面视图图片的 file_id。

每张视图都需要先通过 POST /files 上传。
front 正面图必填，用来确定模型的主要朝向。

views.left/back/right.file_idstring可选

默认: 多视图至少填一个示例: file_left...

多视图生成时，left、back、right 至少再填一个。

视图越完整，通常越有利于还原物体形体。
不要伪造缺失视图；只提交真实上传过的视图。

qualitybasic | advanced可选

默认: basic示例: basic

基础质量档位，也是 3D 圆雕生成的主要计费参数。默认 basic。

basic基础质量，任务接受时扣 50 API 点。适合普通预览和常规模型。

advanced高级质量，任务接受时扣 80 API 点。适合需要更高几何质量的模型。

basic：任务接受时扣 50 API 点。
advanced：任务接受时扣 80 API 点。
价格示例：basic=50，basic+texture=60，basic+texture+pbr=70，advanced=80，advanced+texture=90，advanced+texture+pbr=100。

textureboolean可选

默认: false示例: false可选: true, false

是否生成贴图。默认 false；设置为 true 会额外扣 10 API 点。

false默认值。不生成贴图，只返回模型本体。

true生成贴图，额外扣 10 API 点。

只需要模型几何结构时填 false。
需要颜色或材质贴图随模型一起返回时填 true。

pbrboolean可选

默认: false示例: false可选: true, false

是否生成 PBR 材质贴图。默认 false；设置为 true 必须同时 texture=true，并额外扣 10 API 点。

false默认值。不生成 PBR 材质贴图。

true生成 PBR 材质贴图，必须同时 texture=true，并额外扣 10 API 点。

合法组合：texture=true 且 pbr=true。
非法组合：texture=false 且 pbr=true。

Idempotency-Keyheader可选

默认: 可不填示例: model-request-001

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

响应示例

200application/json

{
  "id": "task_...",
  "object": "model_job",
  "status": "queued",
  "product": "model",
  "mode": "image_to_model",
  "points": 50,
  "progress": 0,
  "artifacts": []
}