Gambar ke model 3D
AktifMasukkan gambar atau prompt, dapatkan model 3D bertekstur: GLB, FBX, dan thumbnail. Buat karakter yang siap di-rig, atau properti.
Gambar ke model 3D
Input
promptYang ingin dibuat, dalam kata-kata.kindcharacter atau prop.Benda seperti senjata, topi, atau perabot. Tanpa rig.qualityStandar atau detail tinggi.engineMesin 3D yang menjalankannya (hanya dikirim bila ada lebih dari satu).3D standar × Properti3D standar × Properti
Cara kerja pipeline 3D
Langkah yang sama yang kami pakai untuk membuat karakter bagi game kami sendiri.
- 01Cek T-posePemeriksaan singkat atas gambarmu. Jika bukan T-pose tampak depan yang tegas dengan mulut tertutup dan netral di latar polos, gambar dibuat ulang seperti itu dengan karakter yang sama. Lengan yang terentang menjaga tangan tetap rapi.
- 02Model 3DMesh bertekstur yang siap untuk game, dibuat dari gambar T-pose, dengan material PBR dan tanpa pencahayaan yang tertanam. Karakter dan properti punya batas segitiga masing-masing.
- 03RigKerangka yang dipasang ke karakter agar bisa bergerak, dengan klip jalan dan lari bila diminta. Kamu mendapat FBX untuk mesin game dan GLB untuk web.
Jalankan ketiga langkah dalam satu panggilan:Karakter 3D
Panggil Gambar ke model 3D dari kode Anda
Setiap alat 3D punya endpoint sendiri. Setiap panggilan mengembalikan tugas: periksa sampai selesai. Proses yang gagal tidak ditagih.
https:/ / api.opennan.com/ v1/ 3d/ models- POST
/Gambar atau prompt menjadi karakter ber-rig.v1/ 3d/ characters - POST
/Gambar karakter apa pun menjadi T-pose tampak depan.v1/ 3d/ tpose - POST
/Model humanoid menjadi FBX dan GLB ber-rig.v1/ 3d/ rig - GET
/Progres dan file hasil.v1/ tasks/ {id} - GET
/Mesin 3D dan tingkat kualitas, dengan hargav1/ models? category= 3d
Dapatkan kunci API
Buat kunci di konsol. Kunci memakai saldo yang sama dengan playground.
Buat kunciKirim permintaan pertama
Permintaan yang sama dengan yang dikirim playground. Isi OPENNAN_KEY dengan kunci Anda.
curl https://api.opennan.com/v1/3d/models \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt":"a wooden treasure chest with gold trim","kind":"prop","quality":"standard","engine":"opennan-3d-studio"}' # Then poll until "status" is "succeeded" or "failed": curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"Periksa tugasnya
Panggilan langsung menjawab dengan id tugas. Periksa tugas itu sampai selesai:
GEThttps:// api.opennan.com/ v1/ tasks/ {id} - queued
- Menunggu worker
- running
- Sedang dibuat
- succeeded
- Selesai: outputs[].url berisi berkasnya
- failed
- Gagal: tidak ditagih
Galat dan cara memperbaikinya
401Kunci tidak ada atau salah
Kirim header Authorization: Bearer dengan kunci dari konsol.
402Saldo tidak cukup
Tambah saldo di Penagihan, lalu kirim panggilan yang sama lagi.
400Ada nilai yang ditolak
Baca error.message: di sana tertulis kolomnya. Pakai nilai dari tabel parameter.
429Terlalu banyak permintaan
Tunggu beberapa detik lalu coba lagi, dan tunggu lebih lama setelah setiap 429.
Tambahkan Opennan ke aplikasi AI Anda
Sekali pasang, AI Anda bisa memakai semua alat Opennan: video, gambar, chat, suara, musik, efek suara, 3D, teks film, dan sulih suara. Pilih aplikasi Anda dan ikuti langkahnya.
https:/ / api.opennan.com/ v1/ mcpBerfungsi di Codex CLI, aplikasi Codex, dan ekstensi Codex untuk IDE: semuanya memakai ~/.codex/config.toml. Jika aplikasi atau IDE tidak membaca OPENNAN_KEY, pakai opsi config.toml berisi kunci Anda. Codex meminta izin sebelum tiap panggilan alat: setujui untuk lanjut.
Dapatkan kunci API
Buat kunci di konsol. Kunci diawali sk- dan memakai saldo yang sama dengan situs.
Buat kunciSimpan kunci Anda sebagai OPENNAN_KEY
# macOS / Linux (zsh shown; bash: ~/.bashrc) echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc source ~/.zshrc # Windows (PowerShell), then open a new terminal setx OPENNAN_KEY "sk-..."Pasang plugin Opennan: server plus skill yang mengajari AI Anda memilih model, mengonfirmasi harga, dan menunggu hasil
codex plugin marketplace add Opennan/opennan-ai-plugin codex plugin add opennan@opennanAtau tambahkan servernya saja
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEYAtau tambahkan ini ke ~/.codex/config.toml
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }Pastikan opennan ada di daftar
codex mcp listMulai ulang Codex, lalu minta apa saja
“Buat video 5 detik hujan di jalan neon, lagu pengiringnya, dan gambar poster.”
Ganti sk-... dengan kunci Anda sendiri dan rahasiakan: siapa pun yang memilikinya bisa memakai saldo Anda. Aplikasi bisa menampilkan daftar alat tanpa kunci; untuk membuat sesuatu perlu kunci.
Pakai dari agen AI
Tambahkan server MCP Opennan ke agen Anda dan panggil alat ini.
- Alat
- generate_3d_model
- Contoh argumen
{ "prompt": "a wooden treasure chest with gold trim", "kind": "prop", "quality": "standard", "engine": "opennan-3d-studio" }
Gambar ke model 3D: pertanyaan
Berapa biaya Gambar ke model 3D?
Anda membayar per run, sesuai harga yang tampil sebelum mulai.
Bagaimana memanggilnya dari kode saya?
Kirim POST https://api.opennan.com/v1/3d/models dengan kunci API Anda. Jawabannya berupa id tugas: periksa https://api.opennan.com/v1/tasks/{id} sampai tugas berhasil atau gagal.
Bisakah agen AI saya memakainya?
Bisa. Tambahkan server MCP https://api.opennan.com/v1/mcp dan panggil alat generate_3d_model, atau arahkan agen Anda ke https://api.opennan.com/llms.txt.
Apa yang terjadi jika run gagal?
Run yang gagal tidak ditagih. Anda hanya membayar hasil.
Mengapa gambar perlu T-pose?
Lengan yang terentang lurus menjauhkan tangan dari tubuh, sehingga model mendapat tangan yang rapi dan rig menekuk di sendi yang tepat. Lengan ke bawah atau A-pose sering membuat tangan menyatu dengan pakaian, dan senyuman ikut tergambar di tekstur. Karena itu gambar yang bukan T-pose dibuat ulang lebih dulu, dengan karakter yang sama.
File apa saja yang saya dapat?
GLB untuk web, mesin game, dan aplikasi 3D, FBX untuk Roblox Studio, Unity, Unreal, dan Blender, serta thumbnail. Proses ber-rig menambahkan klip jalan dan lari.