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. 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. 2

    Mulai pembuatan

    POST/generate/cloud/ultra

    Kirim satu foto sebagai field multipart file. Responsnya berisi task_id.

  3. 3

    Cek status tugas

    GET/task/{task_id}/status

    Setiap beberapa detik, sampai status menjadi done; responsnya lalu berisi model_id.

  4. 4

    Unduh

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

    GLB 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": "…"}}
Statusdetail.errorArti
400invalid_image_urlimage_url_unreachableimage_url_too_largeimage_url_not_imagePermintaan tidak bisa dipakai seperti yang dikirim: tautan gambar yang tidak bisa kami unduh, parameter atau URL callback yang salah. Tidak ada biaya.
401invalid_api_keyKunci tidak ada, salah, atau sudah dicabut.
402insufficient_balancemonthly_limit_reachedkey_limit_reachedSaldo API tidak cukup, atau batas bulanan (akun atau kunci) sudah tercapai.
403subscription_requiredsession_requiredPerlu sesi login di situs web, atau paket untuk mengunduh model yang dibuat di situs web.
404feature_offTidak ditemukan, atau belum tersedia untuk Anda.
409file_not_readyFile model belum siap.
409idempotency_key_reusedidempotency_in_progressIdempotency-Key sudah dipakai dengan permintaan lain, atau permintaan pertamanya masih berjalan.
429rate_limitedtoo_many_jobsBatas permintaan tercapai, atau terlalu banyak pembuatan berjalan bersamaan.

Harga

Biaya satu model dalam dolar AS, dari daftar harga API terkini.

Harga API per model yang dibuat, dalam dolar AS
VersiSatu foto2–4 sudut
Wandy 1/generate/cloud/fastUS$0,09US$0,24
Wandy 1.1/generate/cloudUS$0,15US$0,27
Wandy 2/generate/cloud/ultraUS$0,18US$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.

Lihat harga API

Endpoint

Seluruh API publik dalam satu tabel. Setiap rute memakai kunci Bearer yang sama.

Pembuatan

MetodePathFungsinya
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

MetodePathFungsinya
GET/task/{task_id}/status
Progres pembuatan
GET/api/generate/eta
Berapa lama pembuatan model saat ini

Pustaka

MetodePathFungsinya
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

MetodePathFungsinya
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

MetodePathFungsinya
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.

Rahasia webhook dan event uji
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/mcp

Tambahkan 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

  1. Di pengaturan konektor aplikasi, tambahkan konektor kustom dengan URL server di atas.
  2. Masuk dengan Wandy3D saat aplikasi memintanya, lalu izinkan koneksi.
  3. Minta model. Model dibuat dengan kredit Wandy3D Anda sesuai harga di situs.

Gunakan kunci API

Claude Code, Cursor, VS Code, dan skrip Anda sendiri

  1. Buat kunci di platform API dan isi saldo API Anda.
  2. Tambahkan server dengan kunci di header Authorization — contohnya di bawah.
  3. 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 gambar
  • generate_from_textBuat model 3D dari deskripsi
  • get_taskPantau pembuatan dan tampilkan model yang sudah jadi
  • list_modelsJelajahi pustaka Anda
  • get_modelBuka salah satu model Anda
  • export_modelUnduh GLB, FBX, OBJ, USDZ, atau STL
  • check_printPeriksa model untuk cetak 3D, gratis: hasil penilaian, ukuran cetak, bahan, waktu cetak, perbaikan
  • make_low_polyBuat versi Low Poly untuk game, AR, dan web
  • rig_modelBeri model kerangka dan animasi siap pakai
  • list_animationsTampilkan klip animasi model yang sudah di-rig
  • animate_faceAnimasikan wajah model: bentuk ekspresi dan klip siap pakai — senyum, berkedip, berbicara, dan lainnya
  • make_craftUbah model menjadi papercraft, lapisan potong laser, set balok, atau mainan fleksibel
  • get_creditsCek saldo dan harga: kredit, atau saldo API Anda jika terhubung dengan kunci
  • browse_galleryLihat contoh model di penampil 3D, tanpa perlu masuk
  • get_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.

Dapatkan kunci API

Penyempurnaan geometri — Powered by Hi3D 1.0