Wandy3D

Wandy3D API

用你的代码、引擎或 AI 智能体生成 3D 模型

发送一张照片、几个视角或一句话，即可获得带纹理的 3D 模型——还能导出、3D 打印、重拓扑为四边面、自动绑定骨骼，或打包到游戏引擎。与工作室相同的流程，通过普通 HTTPS 调用。

获取 API 密钥查看全部接口
  • 按次从预付余额付费
  • Bearer 密钥认证
  • 每个密钥每分钟 60 次请求
  • 基于 HTTPS 的 REST 和 JSON
# 1. Start a generation from a photo (Wandy 2)curl -s -X POST "https://api.wandy3d.com/generate/cloud/ultra" \  -H "Authorization: Bearer $WANDY3D_API_KEY" \  -F "file=@photo.jpg"# → {"task_id": "<task_id>", "status": "queued", "billing": {"cost_usd": "<price>", "balance_usd": "<balance>"}, …}

快速上手

从照片到 GLB 文件只需四步。

  1. 1

    创建密钥

    在 API 平台的「API 密钥」中创建，然后为 API 余额充值。密钥只显示一次——请保存在环境变量中，例如 WANDY3D_API_KEY。

  2. 2

    开始生成

    POST/generate/cloud/ultra

    把一张照片作为 multipart 字段 file 发送。响应中包含 task_id。

  3. 3

    轮询任务

    GET/task/{task_id}/status

    每隔几秒查询一次，直到 status 为 done；此时响应中包含 model_id。

  4. 4

    下载

    GET/model/{model_id}/export?format=glb

    GLB 会立即返回一个短时有效的链接。其他格式需要先转换——请轮询同一地址直到就绪。

# 1. Start a generation from a photo (Wandy 2)curl -s -X POST "https://api.wandy3d.com/generate/cloud/ultra" \  -H "Authorization: Bearer $WANDY3D_API_KEY" \  -F "file=@photo.jpg"# → {"task_id": "<task_id>", "status": "queued", "billing": {"cost_usd": "<price>", "balance_usd": "<balance>"}, …}# 2. Poll until "status" is "done"curl -s "https://api.wandy3d.com/task/<task_id>/status" \  -H "Authorization: Bearer $WANDY3D_API_KEY"# → {"status": "done", "model_id": "<model_id>", …}# 3. Get a download link, then download the GLBcurl -s "https://api.wandy3d.com/model/<model_id>/export?format=glb" \  -H "Authorization: Bearer $WANDY3D_API_KEY"# → {"status": "ready", "url": "<download_url>", "filename": "<name>.glb", …}curl -L -o model.glb "<download_url>"

密钥与限制

每个请求都在 Authorization 请求头中携带你的密钥。

Authorization: Bearer hg_live_…

妥善保管密钥

密钥以您的身份操作并消耗您的 API 余额。请在服务器、脚本或 CI 中使用——切勿放在网页或移动应用里。密钥泄露时请在 API 平台撤销，它会立即失效。

速率限制

每个密钥每分钟 60 次请求。超出限制时返回 429，并带有 retry_after——需要等待的秒数。

最多 10 个密钥

每个应用或每台机器用一个密钥，这样吊销其中一个不会影响其他。

错误

错误以 JSON 返回，大多数在 detail.error 中带有稳定的错误码：

{"detail": {"error": "rate_limited", "retry_after": <seconds>, "message": "…"}}
状态码detail.error含义
401invalid_api_key缺少密钥、密钥错误或已被吊销。
402insufficient_balancemonthly_limit_reachedkey_limit_reachedAPI 余额不足，或已达到月度限额（账户或密钥）。
403subscription_requiredsession_required需要在网站登录，或需要套餐才能下载在网站上制作的模型。
404feature_off未找到，或暂时对你不可用。
409file_not_ready模型文件尚未就绪。
429rate_limitedtoo_many_jobs达到速率限制，或同时运行的生成任务过多。

价格

每次付费调用都以美元从预付 API 余额扣费。银行卡 $5 起充，余额永不过期，失败的任务自动退款。

通过 API 生成的模型归您所有，可免费下载全部格式。

查看 API 价格

接口

全部公开 API 汇总在一张表里。每个接口都使用同一个 Bearer 密钥。

OpenAPI 文档 ↗

生成

方法路径作用
POST/generate/cloud/ultra
一张照片生成模型，Wandy 2付费
POST/generate/cloud
从一张照片生成模型（Wandy 1.1）付费
POST/generate/cloud/fast
从一张照片生成模型（Wandy 1）付费
POST/generate/cloud/multi/ultra
2–4 个视角生成模型，Wandy 2付费
POST/generate/cloud/multi
从同一物体的 2–4 个视角生成模型（Wandy 1.1）付费
POST/generate/cloud/multi/fast
从 2–4 个视角生成模型（Wandy 1）付费
POST/generate/text/imagine
文字提示 → 概念图付费
POST/generate/text
概念图 → 3D 模型付费
POST/generate/retexture
根据照片为模型重新贴图付费

任务

方法路径作用
GET/task/{task_id}/status
生成进度

模型库

方法路径作用
GET/library
你的模型，最新的在前
GET/model/{model_id}
单个模型及其 GLB 链接

下载与后处理

方法路径作用
GET/model/{model_id}/export
下载为 GLB、FBX、OBJ、USDZ、STL 或 Draco GLB下载
GET/model/{model_id}/print
可直接打印的 STL 或 3MF下载
GET/model/{model_id}/retopo
四边面重拓扑并烘焙纹理付费下载
GET/model/{model_id}/rig
自动绑定骨骼并附带动画付费
GET/model/{model_id}/parts
将模型拆分为部件付费
GET/model/{model_id}/gamepack
带 LOD 和碰撞体的游戏资源包付费下载
GET/model/{model_id}/make/{kind}
手工制作，例如纸模付费

账户

方法路径作用
GET/api/platform/balance
您的 API 余额
GET/api/platform/prices
实时价格表

发起你的第一次 API 调用

在 API 平台创建密钥并充值——只需一分钟。

获取 API 密钥