PopNowAPI
获取 API 密钥

Seed3D 2.0 API

ByteDance 出品

一张图出贴图丰富的 3D 模型，角色手办尤其好

bytedance/seed3d-2.0/image-to-3d
  • 图片转 3D

关于 Seed3D 2.0

一张图出贴图丰富的 3D 模型，角色手办尤其好。

在 POST /jobs/createTask 里把模型名写成 bytedance/seed3d-2.0/image-to-3d 即可调用，US$0.48 起。

简介

Seed3D 2.0 是字节跳动 Seed 团队的 3D 资产模型，2026 年 4 月发布。它读取一张图片，把其中的物体构建为带材质的完整 3D 网格，因此一张产品图或角色渲染图就能变成可以旋转、打光并放进场景中的模型。请求包含一张图片（image_url）和一个可选的密度开关（mesh_detail），没有提示词、seed 或风格字段。结果是一个二进制 glTF 文件（.glb），贴图已打包在文件内。

主要特点

从一张图得到几何与材质

Seed3D 2.0 会同时生成形状和基于物理的材质。在我们的测试中，每个模型都返回两张 4096×4096 贴图：基础色贴图和金属粗糙度贴图，因此皮革显得磨损、哑光，黄铜扣眼和头盔面罩则会出现高光。没有单独的法线贴图，表面细节就在网格本身。

致密的封闭网格

在默认的 medium 档位下，两个测试模型都生成了略低于 50 万个三角面的单一网格和单一材质；在 low 档位下，同一只靴子为 99,977 个面。官方将各档位描述为约 10 万、50 万和 100 万个面。网格越密，鞋带、缝线和手指等小细节保留得越好；网格越轻，在浏览器中加载越快。

我们的实测

我们分别提交了一张 1024×1024 的皮靴影棚照片和一张 682×1024 的玩具宇航员渲染图。两者都返回了有效的 GLB 文件：分别为 37.2 MB 和 28.6 MB，三角面数 499,998 和 499,992，处理耗时 356 秒和 340 秒。宇航员的面部、面罩、胸口面板和橙色装饰在各个角度都保留完整。皮靴以正面平视图提交，结果的背面是正面的镜像。

请求参数

参数必填说明
image_url是作为起点的那张图。
mesh_detail否网格密度：low（约 10 万面）、medium（约 50 万面）或 high（约 100 万面）。三档价格相同；档位越高细节越多，文件也越大。 low · medium · high · 默认值: medium

价格

价格以美元计。API 使用独立的美元余额。网站积分不能用于 API，也不能转入 API 余额；API 余额同样不能转为网站积分。 任务受理时，从 API 余额中冻结报价的最高金额；完成后按实际用量结算，实扣不超过冻结额，并释放剩余金额。任务失败则释放冻结额。

选项USD /次
标准US$0.48

运行前，将相同请求体发送到 POST /jobs/quote，可查看预计费用和最高费用，单位为美元。报价不会运行任务或扣款。

适用场景

电商与商品展示

一张商品图即可变成商品详情页或 AR 预览中的可交互模型。请在纯色背景上以四分之三角度拍摄或渲染商品，保证整个物体在画面内，并使用 medium 档位，在细节与下载体积之间取得平衡。

角色、玩具与收藏品

角色渲染图和手办照片转换效果很好，因为它们的形状简单、颜色鲜明。贴图会承载绘制的细节，例如脸部、徽章和条纹；背面是推断出来的，所以请选择能看到角色大部分的姿势。

提示词指南与进阶技巧

准备好图片

画面中只放一个主体，居中放置，四周留一些空白，且不要贴到画面边缘。浅色纯色背景能让物体与背景清楚分开。接受 JPEG、PNG 或 WebP，不超过 10 MB，图片的宽高比应在约 2:5 到 5:2 之间。

有意识地选择角度

模型只能看到物体的一侧。鞋子或汽车的正面平视图无法体现物体的长度，被遮挡的另一半可能会被补成正面的镜像。展示正面与一侧的四分之三视角，结果要可靠得多。

根据使用场景选择细节档位

移动端预览和道具较多的场景用 low，大多数网页查看器用 medium，模型需要近距离查看或用于 3D 打印时用 high。

上线前先检查结果

在查看器中打开 GLB，完整旋转一圈，检查你没有展示的那一面。如果背面不对，请换一个拍摄角度的照片，而不是换一个细节档位。

API 快速上手

三步调用 Seed3D 2.0 API

  1. 创建 API 密钥. 登录 PopNow，在 API 控制台创建密钥。密钥以 sk-popnow- 开头，API 调用使用独立的美元余额。
  2. 发送请求. 向 POST /jobs/createTask 发请求，model 填 bytedance/seed3d-2.0/image-to-3d，input 按参数表填写。响应会立刻返回任务 ID。
  3. 取回结果. 用任务 ID 轮询 GET /jobs/recordInfo，或者传 callBackUrl，结果会推送到这个地址。任务成功后下载输出链接。
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seed3d-2.0/image-to-3d",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "mesh_detail": "medium"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

请替换为自己的提示词与素材链接。响应格式、轮询与回调说明请参阅 API 页签。

Seed3D 2.0 API 常见问题

Seed3D 2.0 API 怎么收费？

Seed3D 2.0：US$0.48/次。API 使用独立的美元余额。网站积分不能用于 API，也不能转入 API 余额；API 余额同样不能转为网站积分。 任务受理时，从 API 余额中冻结报价的最高金额；完成后按实际用量结算，实扣不超过冻结额，并释放剩余金额。任务失败则释放冻结额。

Seed3D 2.0 在 API 里的调用名是什么？

在 POST /jobs/createTask 的 model 字段里填 图片转 3D用 bytedance/seed3d-2.0/image-to-3d。

Seed3D 2.0 API 有哪些限制？

单个文件大小上限：10 MB。超出这些限制的请求会在扣费之前被拒绝。

不写代码能试 Seed3D 2.0 吗？

无需 API 密钥，即可在 Playground 用 API 美元余额运行 Seed3D 2.0。每次运行记入开发者历史，并附对应代码。

关于 Seed3D 2.0 的更多内容