Langkau ke kandungan

Hi3D Texture

Integrasikan

ID model hitem3d/hi3d/texture
# 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/hitem3d/hi3d/texture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# 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
Hitem3D · 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

Bekalkan rujukan tekstur melalui URL, menggunakan imej PNG, JPEG atau WebP dengan saiz fail maksimum 20 MB.

resolution

Pilih resolusi tekstur atau biarkan tidak ditetapkan untuk menggunakan cadangan model. Untuk scene-portraitv1.5, satu-satunya pilihan ialah 1536, manakala hitem3dv1.5 menyokong 512, 1024, 1536 dan 1536pro.

•diperlukan

Bekalkan geometri untuk diberi tekstur melalui URL dalam format GLB; tiada format lain disokong. Satu sumber yang sesuai ialah output geometri image-to-3d yang dijana dengan enable_texture=false.

Lanjutan model · export_format · enable_safety_checker
model lalai hitem3dv1.5

Versi model yang digunakan untuk tekstur. Tugas tekstur berperingkat memerlukan model v1.5.

export_format lalai glb

Format yang digunakan untuk menyimpan model yang dijana.

POST /run/hitem3d/hi3d/texture?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/hitem3d/hi3d/texture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# 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 Hi3D Texture

Mengaplikasikan tekstur pada geometri GLB sedia ada tanpa tekstur, berpandukan imej rujukan (PNG, JPEG atau WebP, sehingga 20MB). Hanya model v1.5 disokong: hitem3dv1.5 menawarkan resolusi 512 hingga 1536pro, manakala varian potret menggunakan 1536. Format eksport ialah glb, obj, stl, fbx dan usdz.

Parameter

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

NamaJenis LalaiDibenarkan Penerangan
image_urldiperlukan image
Jenisurl · image
Bekalkan rujukan tekstur melalui URL, menggunakan imej PNG, JPEG atau WebP dengan saiz fail maksimum 20 MB.
mesh_urldiperlukan
Jenisstring
Bekalkan geometri untuk diberi tekstur melalui URL dalam format GLB; tiada format lain disokong. Satu sumber yang sesuai ialah output geometri image-to-3d yang dijana dengan enable_texture=false.
modelpilihan
Jenisenum
Lalaihitem3dv1.5
hitem3dv1.5scene-portraitv1.5
Versi model yang digunakan untuk tekstur. Tugas tekstur berperingkat memerlukan model v1.5.
resolutionpilihan
Jenisenum
512102415361536pro
Pilih resolusi tekstur atau biarkan tidak ditetapkan untuk menggunakan cadangan model. Untuk scene-portraitv1.5, satu-satunya pilihan ialah 1536, manakala hitem3dv1.5 menyokong 512, 1024, 1536 dan 1536pro.
export_formatpilihan
Jenisenum
Lalaiglb
glbobjstlfbxusdz
Format yang digunakan untuk menyimpan model yang dijana.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Suis pemeriksaan keselamatan untuk imej input: true memerlukan pemeriksaan keselamatan sebelum pemprosesan imej bermula.
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": "hitem3d/hi3d/texture",
  "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",
    "mesh_url": "https://example.com/your-file.glb"
  },
  "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
    },
    "thumbnail": {
      "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
    }
  },
  "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 model 3D yang dijana.
thumbnail
object {url, content_type, file_name, file_size} | nullImej pratonton model, jika tersedia.

Lebih banyak model: 3D

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