Langkau ke kandungan

Pixal3d

Integrasikan

ID model pixal3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/pixal3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Permintaan ini: $0.30 300 kredit API Jalankan pada halaman ini

Dapatkan kunci API
Open model Imej ke 3D #stylized#transform

Menukar satu imej menjadi model 3D GLB bertekstur dengan kawalan terperinci bagi setiap peringkat penjanaan

Open model · 3D

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan image_url
Lepaskan fail, atau

URL yang menunjuk kepada imej sumber untuk penukaran 3D.

resolution lalai 1024

Resolusi output; meningkatkannya menambah perincian tetapi mengambil masa lebih lama.

Lanjutan texture_size · ss_guidance_strength · ss_guidance_rescale · ss_sampling_steps · ss_rescale_t · shape_slat_guidance_strength · shape_slat_guidance_rescale · shape_slat_sampling_steps · shape_slat_rescale_t · tex_slat_guidance_strength · tex_slat_guidance_rescale · tex_slat_sampling_steps · tex_slat_rescale_t · mesh_scale · max_num_tokens · decimation_target · seed · remesh · enable_safety_checker
texture_size lalai 2048

Resolusi tekstur mesh untuk baking. Perincian permukaan yang lebih halus menghasilkan fail yang lebih besar apabila resolusi ini ditingkatkan.

lalai 7.5

Kawalan kesetiaan struktur 3D awal: meningkatkannya mengutamakan keserupaan lebih dekat dengan imej input dengan risiko hingar tambahan.

lalai 0.7

Kawalan artifak panduan peringkat 1, yang menukar kesan panduan lebih kuat pada tetapan rendah dengan output lebih stabil pada tetapan tinggi.

lalai 12

Bilangan penyahhingaran struktur awal: peningkatan kualiti berpotensi daripada langkah tambahan disertai pemprosesan yang lebih perlahan.

lalai 5

Tetapkan ketajaman peralihan melalui jadual hingar penjanaan struktur: meningkatkan nilai ini menjadikan peralihan lebih tajam.

lalai 7.5

Kawalan kesetiaan geometri terperinci: pematuhan yang lebih tinggi kepada imej input menghasilkan perincian tambahan, dengan risiko hingar tambahan.

lalai 0.5

Tingkatkan tetapan ini apabila geometri kelihatan bising: ia mengurangkan artifak yang disebabkan oleh panduan kuat semasa peringkat bentuk.

lalai 12

Bilangan penyahhingaran penapisan bentuk: geometri yang berpotensi lebih licin mengorbankan kelajuan apabila langkah tambahan digunakan.

lalai 3

Tetapkan ketajaman perincian geometri melalui jadual hingar penapisan bentuk; meningkatkan nilai ini menghasilkan perincian yang lebih tajam.

lalai 1

Kawalan kesetiaan warna tekstur: pematuhan yang lebih dekat kepada warna dalam imej input pada tetapan lebih tinggi meningkatkan kecerahan tetapi boleh menyebabkan terlebih tepu.

lalai 0

Tingkatkan tetapan ini untuk menangani tekstur bising atau jalur warna: ia mengurangkan artifak yang disebabkan oleh panduan kuat semasa peringkat tekstur.

lalai 12

Bilangan langkah penyahhingaran yang digunakan untuk menjana tekstur. Meningkatkan bilangan langkah mengambil masa lebih lama tetapi mungkin menghasilkan tekstur yang lebih bersih.

lalai 3

Tetapkan ketajaman perincian tekstur melalui jadual hingar penjanaan tekstur; meningkatkan nilai ini menghasilkan perincian yang lebih tajam.

lalai 1

Skalakan mesh yang disimpulkan untuk mempengaruhi anggaran jarak kamera yang digunakan oleh model.

lalai 49152

Had token HR untuk pensampel bentuk berlapis, mengimbangi geometri yang lebih halus pada tetapan tinggi dengan penjimatan memori dan masa pemprosesan pada tetapan rendah.

lalai 200000

Sasaran kerumitan mesh, dinyatakan sebagai bilangan bucu untuk hasil akhir. Mengurangkan saiz fail dengan menurunkan sasaran ini turut mengorbankan perincian.

Seed yang digunakan untuk penjanaan rawak yang boleh dihasilkan semula.

POST /run/pixal3d?wait=20 sebut harga → $0.30
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/pixal3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Pixal3d

Menerima satu imej dan mengembalikan model GLB bersama seed yang digunakan. Peringkat struktur, bentuk dan tekstur masing-masing mempunyai tetapan panduan, penskalaan semula, bilangan langkah dan jadual hingar sendiri. `resolution` output ialah 1024 atau 1536, `texture_size` ialah 1024, 2048 atau 4096, dan `decimation_target` menetapkan bilangan bucu daripada 5000 hingga 1586021. `remesh` membina semula topologi.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
image_urldiperlukan image
Jenisurl · image
URL yang menunjuk kepada imej sumber untuk penukaran 3D.
seedpilihan
Jenisinteger | null
Seed yang digunakan untuk penjanaan rawak yang boleh dihasilkan semula.
resolutionpilihan
Jenisenum
Lalai1024
10241536
Resolusi output; meningkatkannya menambah perincian tetapi mengambil masa lebih lama.
ss_guidance_strengthpilihan
Jenisnumber
Lalai7.5
0 – 10
Kawalan kesetiaan struktur 3D awal: meningkatkannya mengutamakan keserupaan lebih dekat dengan imej input dengan risiko hingar tambahan.
ss_guidance_rescalepilihan
Jenisnumber
Lalai0.7
0 – 1
Kawalan artifak panduan peringkat 1, yang menukar kesan panduan lebih kuat pada tetapan rendah dengan output lebih stabil pada tetapan tinggi.
ss_sampling_stepspilihan
Jenisinteger
Lalai12
1 – 50
Bilangan penyahhingaran struktur awal: peningkatan kualiti berpotensi daripada langkah tambahan disertai pemprosesan yang lebih perlahan.
ss_rescale_tpilihan
Jenisnumber
Lalai5
1 – 6
Tetapkan ketajaman peralihan melalui jadual hingar penjanaan struktur: meningkatkan nilai ini menjadikan peralihan lebih tajam.
shape_slat_guidance_strengthpilihan
Jenisnumber
Lalai7.5
0 – 10
Kawalan kesetiaan geometri terperinci: pematuhan yang lebih tinggi kepada imej input menghasilkan perincian tambahan, dengan risiko hingar tambahan.
shape_slat_guidance_rescalepilihan
Jenisnumber
Lalai0.5
0 – 1
Tingkatkan tetapan ini apabila geometri kelihatan bising: ia mengurangkan artifak yang disebabkan oleh panduan kuat semasa peringkat bentuk.
shape_slat_sampling_stepspilihan
Jenisinteger
Lalai12
1 – 50
Bilangan penyahhingaran penapisan bentuk: geometri yang berpotensi lebih licin mengorbankan kelajuan apabila langkah tambahan digunakan.
shape_slat_rescale_tpilihan
Jenisnumber
Lalai3
1 – 6
Tetapkan ketajaman perincian geometri melalui jadual hingar penapisan bentuk; meningkatkan nilai ini menghasilkan perincian yang lebih tajam.
tex_slat_guidance_strengthpilihan
Jenisnumber
Lalai1
0 – 10
Kawalan kesetiaan warna tekstur: pematuhan yang lebih dekat kepada warna dalam imej input pada tetapan lebih tinggi meningkatkan kecerahan tetapi boleh menyebabkan terlebih tepu.
tex_slat_guidance_rescalepilihan
Jenisnumber
Lalai0
0 – 1
Tingkatkan tetapan ini untuk menangani tekstur bising atau jalur warna: ia mengurangkan artifak yang disebabkan oleh panduan kuat semasa peringkat tekstur.
tex_slat_sampling_stepspilihan
Jenisinteger
Lalai12
1 – 50
Bilangan langkah penyahhingaran yang digunakan untuk menjana tekstur. Meningkatkan bilangan langkah mengambil masa lebih lama tetapi mungkin menghasilkan tekstur yang lebih bersih.
tex_slat_rescale_tpilihan
Jenisnumber
Lalai3
1 – 6
Tetapkan ketajaman perincian tekstur melalui jadual hingar penjanaan tekstur; meningkatkan nilai ini menghasilkan perincian yang lebih tajam.
mesh_scalepilihan
Jenisnumber
Lalai1
0.1 – 4
Skalakan mesh yang disimpulkan untuk mempengaruhi anggaran jarak kamera yang digunakan oleh model.
max_num_tokenspilihan
Jenisinteger
Lalai49152
4,096 – 131,072
Had token HR untuk pensampel bentuk berlapis, mengimbangi geometri yang lebih halus pada tetapan tinggi dengan penjimatan memori dan masa pemprosesan pada tetapan rendah.
decimation_targetpilihan
Jenisinteger
Lalai200000
5,000 – 1,586,021
Sasaran kerumitan mesh, dinyatakan sebagai bilangan bucu untuk hasil akhir. Mengurangkan saiz fail dengan menurunkan sasaran ini turut mengorbankan perincian.
texture_sizepilihan
Jenisenum
Lalai2048
102420484096
Resolusi tekstur mesh untuk baking. Perincian permukaan yang lebih halus menghasilkan fail yang lebih besar apabila resolusi ini ditingkatkan.
remeshpilihan
Jenisboolean
Lalaitrue
Pembinaan semula topologi mesh yang biasanya memanfaatkan penggunaan hiliran dengan mencipta segi tiga yang lebih bersih, dengan mengorbankan pemprosesan yang lebih lama.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pemeriksaan boleh dilonggarkan dengan menetapkannya kepada false, jika pemanggil dibenarkan.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "pixal3d",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "seed": 42
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
model_glb
object {url, content_type, file_name, file_size}Model 3D yang dijana dalam format GLB.
seed
integerNilai seed yang sebenarnya digunakan.

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/pixal3d.md. Semua model dan panduan: https://doitong.com/developers/llms.txt