Langkau ke kandungan

Trellis

Integrasikan

ID model trellis
# 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/trellis?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.02 20 kredit API Jalankan pada halaman ini

Dapatkan kunci API
Microsoft Imej ke 3D #stylized

Penjana imej tunggal-ke-jejaring 3D dengan kawalan saiz tekstur dan pemudahan jejaring

Microsoft · 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.

Lanjutan texture_size · ss_guidance_strength · ss_sampling_steps · slat_guidance_strength · slat_sampling_steps · mesh_simplify · seed
texture_size lalai 1024

Resolusi yang digunakan untuk tekstur.

lalai 7.5

Keamatan panduan yang digunakan ketika menjana struktur jarang.

lalai 12

Bilangan langkah pensampelan yang digunakan untuk menjana struktur jarang.

lalai 3

Keamatan panduan yang digunakan ketika menjana laten berstruktur.

lalai 12

Bilangan langkah pensampelan yang digunakan untuk menjana laten berstruktur.

lalai 0.95

Faktor yang mengawal pemudahan mesh.

Seed yang digunakan untuk penjanaan rawak yang boleh dihasilkan semula.

POST /run/trellis?wait=20 sebut harga → $0.02
# 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/trellis?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 Trellis

Menukar satu imej daripada `image_url` kepada mesh 3D bertekstur. Parameter boleh laras termasuk kekuatan panduan dan langkah pensampelan untuk peringkat struktur dan laten, `mesh_simplify` (0.9 hingga 0.98), serta `texture_size` 512, 1024 atau 2048. `seed` menjadikan hasil boleh diulang.

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.
ss_guidance_strengthpilihan
Jenisnumber
Lalai7.5
0 – 10
Keamatan panduan yang digunakan ketika menjana struktur jarang.
ss_sampling_stepspilihan
Jenisinteger
Lalai12
1 – 50
Bilangan langkah pensampelan yang digunakan untuk menjana struktur jarang.
slat_guidance_strengthpilihan
Jenisnumber
Lalai3
0 – 10
Keamatan panduan yang digunakan ketika menjana laten berstruktur.
slat_sampling_stepspilihan
Jenisinteger
Lalai12
1 – 50
Bilangan langkah pensampelan yang digunakan untuk menjana laten berstruktur.
mesh_simplifypilihan
Jenisnumber
Lalai0.95
0.9 – 0.98
Faktor yang mengawal pemudahan mesh.
texture_sizepilihan
Jenisenum
Lalai1024
51210242048
Resolusi yang digunakan untuk tekstur.
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": "trellis",
  "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": 20,
    "usd": "0.02",
    "charged": 20,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_mesh": {
      "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
    },
    "timings": {}
  },
  "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_mesh
object {url, content_type, file_name, file_size}Fail yang mengandungi mesh 3D yang dijana.
timings
objectUkuran masa untuk pemprosesan.

Lebih banyak model: Imej ke 3D

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