Wandy3D API
Buat model 3D dari kode, engine, atau agen AI Anda
Kirim foto, beberapa sudut, atau satu kalimat, lalu dapatkan model 3D bertekstur — kemudian ekspor, cetak 3D, remesh jadi quad, buat rig, atau kemas untuk game engine Anda. Pipeline yang sama dengan studio, lewat HTTPS biasa.
Mulai US$0,09 per model (Wandy 1) · Wandy 2 US$0,18
US$2,00 gratis untuk dicoba — sekitar 11 model Wandy 2 atau 22 model Wandy 1 dengan kunci API pertama Anda.
- Saldo prabayar tidak pernah kedaluwarsa · tanpa langganan
- Autentikasi dengan kunci Bearer
- 60 permintaan per menit per kunci
- REST dan JSON lewat HTTPS
# 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>"}, …}Panduan cepat
Empat langkah dari foto ke file GLB.
- 1
Buat kunci
Di platform API, pada bagian Kunci API, lalu isi saldo API Anda. Kunci hanya ditampilkan sekali — simpan di variabel lingkungan seperti
WANDY3D_API_KEY. - 2
Mulai pembuatan
POST
/generate/cloud/ultraKirim satu foto sebagai field multipart
file. Responsnya berisitask_id. - 3
Cek status tugas
GET
/task/{task_id}/statusSetiap beberapa detik, sampai
statusmenjadidone; responsnya lalu berisimodel_id. - 4
Unduh
GET
/model/{model_id}/export?format=glbGLB langsung dijawab dengan tautan sementara. Format lain dikonversi dulu — cek URL yang sama sampai siap.
# 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>"Kunci dan batas
Setiap permintaan menyertakan kunci Anda di header Authorization.
Authorization: Bearer hg_live_…Jaga kerahasiaan kunci
Kunci bertindak atas nama Anda dan memakai saldo API Anda. Gunakan dari server, skrip, atau CI — jangan pernah di halaman web atau aplikasi seluler. Cabut kunci yang bocor di platform API: kunci langsung berhenti berfungsi.
Batas permintaan
60 permintaan per menit per kunci. Jika melewati batas, responsnya 429 dengan retry_after — jumlah detik untuk menunggu.
Hingga 10 kunci
Gunakan satu kunci per aplikasi atau mesin, agar Anda bisa mencabut satu tanpa mengganggu yang lain.
Error
Error dikirim dalam JSON. Sebagian besar menyertakan kode tetap di detail.error:
{"detail": {"error": "rate_limited", "retry_after": <seconds>, "message": "…"}}| Status | detail.error | Arti |
|---|---|---|
| 400 | invalid_image_urlimage_url_unreachableimage_url_too_largeimage_url_not_image | Permintaan tidak bisa dipakai seperti yang dikirim: tautan gambar yang tidak bisa kami unduh, parameter atau URL callback yang salah. Tidak ada biaya. |
| 401 | invalid_api_key | Kunci tidak ada, salah, atau sudah dicabut. |
| 402 | insufficient_balancemonthly_limit_reachedkey_limit_reached | Saldo API tidak cukup, atau batas bulanan (akun atau kunci) sudah tercapai. |
| 403 | subscription_requiredsession_required | Perlu sesi login di situs web, atau paket untuk mengunduh model yang dibuat di situs web. |
| 404 | feature_off | Tidak ditemukan, atau belum tersedia untuk Anda. |
| 409 | file_not_ready | File model belum siap. |
| 409 | idempotency_key_reusedidempotency_in_progress | Idempotency-Key sudah dipakai dengan permintaan lain, atau permintaan pertamanya masih berjalan. |
| 429 | rate_limitedtoo_many_jobs | Batas permintaan tercapai, atau terlalu banyak pembuatan berjalan bersamaan. |
Harga
Biaya satu model dalam dolar AS, dari daftar harga API terkini.
| Versi | Satu foto | 2–4 sudut |
|---|---|---|
Wandy 1/generate/cloud/fast | US$0,09 | US$0,24 |
Wandy 1.1/generate/cloud | US$0,15 | US$0,27 |
Wandy 2/generate/cloud/ultra | US$0,18 | US$0,30 |
Setiap panggilan berbayar ditagih dalam dolar AS dari saldo API prabayar Anda. Isi saldo dengan kartu mulai $5 — saldo tidak pernah kedaluwarsa, dan tugas yang gagal dikembalikan otomatis.
Model yang Anda buat lewat API bisa Anda unduh dalam format apa pun, gratis.
Akun baru yang masuk dengan Google atau Apple mendapat US$2,00 pada kunci API pertamanya — sekali saja, tanpa kartu.
Endpoint
Seluruh API publik dalam satu tabel. Setiap rute memakai kunci Bearer yang sama.
Pembuatan
| Metode | Path | Fungsinya |
|---|---|---|
| POST | /generate/cloud/ultra | Model dari satu foto, Wandy 2Berbayar |
| POST | /generate/cloud | Model dari satu foto, Wandy 1.1Berbayar |
| POST | /generate/cloud/fast | Model dari satu foto, Wandy 1Berbayar |
| POST | /generate/cloud/multi/ultra | Model dari 2–4 sudut, Wandy 2Berbayar |
| POST | /generate/cloud/multi | Model dari 2–4 sudut satu objek, Wandy 1.1Berbayar |
| POST | /generate/cloud/multi/fast | Model dari 2–4 sudut, Wandy 1Berbayar |
| POST | /generate/text/imagine | Prompt teks → gambar konsepBerbayar |
| POST | /generate/text | Gambar konsep → model 3DBerbayar |
| POST | /generate/retexture | Tekstur baru untuk model dari fotoBerbayar |
Tugas
| Metode | Path | Fungsinya |
|---|---|---|
| GET | /task/{task_id}/status | Progres pembuatan |
| GET | /api/generate/eta | Berapa lama pembuatan model saat ini |
Pustaka
| Metode | Path | Fungsinya |
|---|---|---|
| GET | /library | Model Anda, terbaru lebih dulu |
| GET | /model/{model_id} | Satu model, tautan GLB-nya, dan objek apa itu |
| DELETE | /model/{model_id} | Hapus model |
| GET | /model/{model_id}/versions | Semua versi model dan file yang dibuat darinya |
Unduhan dan pascapemrosesan
| Metode | Path | Fungsinya |
|---|---|---|
| GET | /model/{model_id}/stream | File GLB modelUnduh |
| GET | /model/{model_id}/export | Unduh sebagai GLB, FBX, OBJ, USDZ, STL, atau Draco GLBUnduh |
| GET | /model/{model_id}/print | STL atau 3MF siap cetak dengan laporan cek cetakUnduh |
| GET | /model/{model_id}/retopo | Remesh quad atau Low Poly dengan tekstur yang di-bakeBerbayarUnduh |
| GET | /model/{model_id}/rig | Rig otomatis dengan klip animasiBerbayar |
| GET | /model/{model_id}/parts | Pisahkan model menjadi beberapa bagianBerbayar |
| GET | /model/{model_id}/gamepack | Paket siap game dengan LOD dan colliderBerbayarUnduh |
| GET | /model/{model_id}/make/{kind} | Pembuat kerajinan, misalnya papercraftBerbayar |
| GET | /model/{model_id}/outputs/{output_id} | Buka lagi file yang dibuat sebelumnya |
| GET | /model/{model_id}/rig/suggest | Rig mana yang cocok — gratis, sebelum Anda membayar |
Akun
| Metode | Path | Fungsinya |
|---|---|---|
| GET | /api/platform/balance | Saldo API Anda |
| GET | /api/platform/prices | Daftar harga terkini |
Setiap respons dan setiap error dari tiap operasi dijelaskan lengkap dengan tipe dan contohnya di dokumen OpenAPI. Buat klien darinya atau serahkan ke agen coding Anda.
Tautan dan percobaan ulang
Kirim tautan alih-alih mengunggah file, dan ulangi permintaan tanpa membayar dua kali.
Foto lewat tautan
Setiap rute foto juga menerima JSON dengan image_url; untuk beberapa sudut, image_urls. Kami mengunduh gambarnya dan memprosesnya persis seperti file yang diunggah. Tautan harus https ke alamat publik, dan filenya JPEG, PNG, atau WebP maksimal 20 MB. Tautan yang tidak bisa kami gunakan akan dijawab 400 sebelum ada biaya yang ditagih.
# One photo by link (Wandy 2) — no uploadcurl -s -X POST "https://api.wandy3d.com/generate/cloud/ultra" \ -H "Authorization: Bearer $WANDY3D_API_KEY" \ -H "Content-Type: application/json" \ -d '{"image_url": "https://images.example.org/chair.jpg"}'# → {"task_id": "<task_id>", "status": "queued", "billing": {…}}# Several views of one object: image_urls, front view firstcurl -s -X POST "https://api.wandy3d.com/generate/cloud/multi/ultra" \ -H "Authorization: Bearer $WANDY3D_API_KEY" \ -H "Content-Type: application/json" \ -d '{"image_urls": ["https://images.example.org/front.jpg", "https://images.example.org/side.jpg"]}'# A link we can't use → 400, nothing is charged# {"detail": {"error": "invalid_image_url", "message": "image_url must use https://."}}Coba ulang dengan aman
Tambahkan header Idempotency-Key ke POST berbayar. Jika permintaan yang sama datang lagi dalam 24 jam — karena timeout atau percobaan ulang dari antrean Anda — Anda mendapat jawaban pertama dengan task_id yang sama, dan tidak ada yang dimulai atau ditagih untuk kedua kalinya. Kunci yang sama dengan permintaan berbeda akan dijawab 409.
KEY=$(uuidgen) # one key per job you want to exist oncecurl -si -X POST "https://api.wandy3d.com/generate/cloud/ultra" \ -H "Authorization: Bearer $WANDY3D_API_KEY" \ -H "Idempotency-Key: $KEY" \ -H "Content-Type: application/json" \ -d '{"image_url": "https://images.example.org/chair.jpg"}'# → 200 {"task_id": "<task_id>", "status": "queued", "billing": {"cost_usd": "<price>", …}}# The connection dropped? Send exactly the same request again (within 24 hours):# → 200, header Idempotent-Replayed: true, the same "task_id" — no second job, no second charge# The same key with a different request → 409# {"detail": {"error": "idempotency_key_reused", "message": "…"}}Webhook
Tak perlu polling: tambahkan callback_url saat memulai pembuatan, dan kami akan mengirim POST berisi satu event bertanda tangan ke server Anda saat selesai.
curl -s -X POST "https://api.wandy3d.com/generate/cloud/ultra?callback_url=https://your.app/hooks/wandy3d" \ -H "Authorization: Bearer $WANDY3D_API_KEY" -F "file=@photo.jpg"# → {"task_id": "…", "webhook": {"callback_url": "https://your.app/hooks/wandy3d", …}}# When the model is ready (or the job fails) we POST one signed event to that URL.Event
task.completed — model sudah siap, lengkap dengan id, nama, serta tautan ke model dan ekspor GLB-nya. task.failed — tugas gagal dan biayanya dikembalikan ke saldo API Anda. ping — tes yang Anda kirim dari dasbor.
Bertanda tangan
Setiap event membawa Wandy-Signature: t=…,v1=… — v1 adalah HMAC-SHA256 dari timestamp, titik, dan body mentah, dengan kunci rahasia webhook dari kunci API yang memulai tugas. Tolak event yang lebih lama dari 5 menit.
Dicoba ulang
Balas dengan 2xx apa pun dalam 10 detik. Selain itu, kami coba ulang 3 kali — setelah 30 dtk, 2 mnt, dan 10 mnt — dengan id event yang sama, jadi duplikat mudah dibuang.
POST /hooks/wandy3dWandy-Signature: t=1761900000,v1=5f0c…Wandy-Event-Id: evt_…Wandy-Event-Type: task.completed{ "id": "evt_…", "type": "task.completed", "created_at": "…", "data": { "task_id": "…", "status": "done", "model_id": "…", "name": "…", "model_url": "https://api.wandy3d.com/model/<model_id>", "export_url": "https://api.wandy3d.com/model/<model_id>/export?format=glb", "cost_usd": "…" }}import crypto from "node:crypto";import express from "express";const app = express();// The signature covers the raw body: read it as bytes, parse after the check.app.post("/hooks/wandy3d", express.raw({ type: "application/json" }), (req, res) => { const parts = Object.fromEntries( (req.get("Wandy-Signature") ?? "").split(",").map((p) => p.split("=")), ); const expected = crypto .createHmac("sha256", process.env.WANDY3D_WEBHOOK_SECRET) .update(`${parts.t}.`) .update(req.body) .digest("hex"); const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300; const valid = typeof parts.v1 === "string" && parts.v1.length === expected.length && crypto.timingSafeEqual(Buffer.from(parts.v1), Buffer.from(expected)); if (!fresh || !valid) return res.sendStatus(400); const event = JSON.parse(req.body.toString("utf8")); if (event.type === "task.completed") { console.log("model ready:", event.data.model_id, event.data.export_url); } res.sendStatus(200); // answer fast; do slow work after});app.listen(3000);Gunakan dengan agen AI
Hubungkan Wandy3D ke Claude, ChatGPT, Cursor, VS Code, atau aplikasi apa pun yang mendukung MCP. Minta model 3D dengan kata-kata biasa: asisten membuatnya di akun Wandy3D Anda dan menampilkannya langsung di chat.
URL server
https://wandy3d.com/mcpTambahkan ke editor dengan sekali klik
Editor akan terbuka dan meminta konfirmasi sebelum menambahkan server. Menjelajahi contoh model dan melihat harga langsung bisa dilakukan. Untuk membuat model, tempelkan kunci API Anda dulu: tombol akan membawanya ke pengaturan editor.
Kunci tetap di browser Anda: kunci hanya dimasukkan ke tautan yang membuka editor Anda.
Dua cara menghubungkan
Masuk dengan Wandy3D
Claude, ChatGPT, dan aplikasi chat lain yang punya konektor
- Di pengaturan konektor aplikasi, tambahkan konektor kustom dengan URL server di atas.
- Masuk dengan Wandy3D saat aplikasi memintanya, lalu izinkan koneksi.
- Minta model. Model dibuat dengan kredit Wandy3D Anda sesuai harga di situs.
Gunakan kunci API
Claude Code, Cursor, VS Code, dan skrip Anda sendiri
- Buat kunci di platform API dan isi saldo API Anda.
- Tambahkan server dengan kunci di header
Authorization— contohnya di bawah. - Panggilan dibayar dalam dolar AS dari saldo API Anda, dan model yang dibuat dengan cara ini bisa diunduh gratis.
claude mcp add --transport http wandy3d \ https://wandy3d.com/mcp \ --header "Authorization: Bearer hg_live_…"Ganti hg_live_… dengan kunci dari platform API. Cursor membaca ~/.cursor/mcp.json, VS Code membaca .vscode/mcp.json; klien MCP apa pun yang bisa mengirim header Authorization dapat digunakan.
Yang bisa dilakukan asisten
generate_from_imageBuat model 3D dari foto, render, atau gambargenerate_from_textBuat model 3D dari deskripsiget_taskPantau pembuatan dan tampilkan model yang sudah jadilist_modelsJelajahi pustaka Andaget_modelBuka salah satu model Andaexport_modelUnduh GLB, FBX, OBJ, USDZ, atau STLcheck_printPeriksa model untuk cetak 3D, gratis: hasil penilaian, ukuran cetak, bahan, waktu cetak, perbaikanmake_low_polyBuat versi Low Poly untuk game, AR, dan webrig_modelBeri model kerangka dan animasi siap pakailist_animationsTampilkan klip animasi model yang sudah di-riganimate_faceAnimasikan wajah model: bentuk ekspresi dan klip siap pakai — senyum, berkedip, berbicara, dan lainnyamake_craftUbah model menjadi papercraft, lapisan potong laser, set balok, atau mainan fleksibelget_creditsCek saldo dan harga: kredit, atau saldo API Anda jika terhubung dengan kuncibrowse_galleryLihat contoh model di penampil 3D, tanpa perlu masukget_pricesLihat harga terkini dalam kredit, tanpa perlu masuk
Penampil 3D di dalam chat
Di klien yang mendukung MCP Apps, model yang sudah jadi terbuka di penampil interaktif langsung dalam percakapan: putar, beralih ke tampilan clay, buka di Wandy3D. Klien lain mendapat gambar pratinjau dan tautan.
Anda melihat harganya dulu
Wandy3D memberi tahu asisten biaya setiap tindakan berbayar, jadi asisten bisa menanyakan Anda dulu sebelum memakai kredit. Pembuatan yang gagal dikembalikan. File model yang dibuat dengan kredit bisa diunduh dengan paket langganan, setelah buka akses sekali bayar, atau dengan kredit: harganya disebutkan lebih dulu, jadi asisten bisa menanyakan Anda.
Lakukan panggilan API pertama Anda
Buat kunci dan isi saldo di platform API — hanya butuh semenit.
Penyempurnaan geometri — Powered by Hi3D 1.0

