Langkau ke kandungan

Tripo H3.1 Text to 3D

Integrasikan

ID model tripo3d/h3.1/text-to-3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/tripo3d/h3.1/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

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

Fail seperti contoh: $0.20 200 kredit API · ≈ ₽21.52 fail anda diukur sebelum dijalankan Jalankan pada halaman ini

Dapatkan kunci API
Tripo Teks ke 3D #3d#text-to-3d#3d-generation#tripo

Penjana jejaring teks-ke-3D dengan prompt negatif, tahap kualiti geometri dan tekstur berasingan, serta had muka yang sangat tinggi

Tripo · 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 88 / 1024

Penerangan teks tentang objek 3D yang dikehendaki, terhad kepada 1024 aksara.

texture_quality lalai standard

Tetapan kualiti tekstur; memilih 'detailed' meningkatkan resolusi tekstur.

geometry_quality lalai standard

Tetapan kualiti untuk geometri.

Lanjutan negative_prompt · face_limit · model_seed · image_seed · texture_seed · auto_size · enable_safety_checker
0 / 1024

Penerangan tentang ciri yang perlu dikecualikan daripada model yang dijana.

Sasaran bilangan muka khusus untuk penjanaan mesh, mengatasi pemilihan bilangan adaptif model apabila diberikan.

Seed yang digunakan untuk menjadikan penjanaan geometri boleh dihasilkan semula.

Seed yang digunakan semasa peringkat teks-ke-imej.

Seed yang digunakan untuk menjadikan penjanaan tekstur boleh dihasilkan semula.

POST /run/tripo3d/h3.1/text-to-3d?wait=20 sebut harga → $0.20
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/tripo3d/h3.1/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/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 Tripo H3.1 Text to 3D

Membina model 3D daripada perihalan teks sehingga 1024 aksara, dengan `negative_prompt` pilihan untuk ciri yang perlu dielakkan. `face_limit` menerima 1,000 hingga 2,000,000 muka. `geometry_quality` dan `texture_quality` masing-masing boleh berupa standard atau terperinci. Pilihan termasuk bahan PBR, topologi quad, penskalaan automatik kepada saiz dunia sebenar dan seed berasingan untuk geometri, langkah teks-ke-imej dan tekstur.

Parameter

NamaJenis LalaiDibenarkan Penerangan
promptdiperlukan
Jenisstring
≤ 1,024 aksara
Penerangan teks tentang objek 3D yang dikehendaki, terhad kepada 1024 aksara.
negative_promptpilihan
Jenisstring | null
≤ 1,024 aksara
Penerangan tentang ciri yang perlu dikecualikan daripada model yang dijana.
face_limitpilihan
Jenisinteger | null
1,000 – 2,000,000
Sasaran bilangan muka khusus untuk penjanaan mesh, mengatasi pemilihan bilangan adaptif model apabila diberikan.
texturepilihan
Jenisboolean
Lalaitrue
Mengawal sama ada model menerima tekstur yang dijana.
pbrpilihan
Jenisboolean
Lalaitrue
Dayakan bahan PBR (Physically Based Rendering), yang turut menghidupkan penjanaan tekstur apabila bernilai true.
model_seedpilihan
Jenisinteger | null
Seed yang digunakan untuk menjadikan penjanaan geometri boleh dihasilkan semula.
image_seedpilihan
Jenisinteger | null
Seed yang digunakan semasa peringkat teks-ke-imej.
texture_seedpilihan
Jenisinteger | null
Seed yang digunakan untuk menjadikan penjanaan tekstur boleh dihasilkan semula.
texture_qualitypilihan
Jenisenum
Lalaistandard
standarddetailed
Tetapan kualiti tekstur; memilih 'detailed' meningkatkan resolusi tekstur.
geometry_qualitypilihan
Jenisenum
Lalaistandard
standarddetailed
Tetapan kualiti untuk geometri.
auto_sizepilihan
Jenisboolean
Lalaifalse
Penskalaan automatik untuk memberikan model dimensi dunia sebenar yang diukur dalam meter.
quadpilihan
Jenisboolean
Lalaifalse
Pilih antara muka segi tiga dan segi empat dengan mendayakan topologi quad. Untuk hasil quad, fail FBX dikembalikan apabila Tripo membekalkan data sebagai bait FBX.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pemeriksaan boleh dilonggarkan dengan menetapkannya kepada false, jika pemanggil dibenarkan.
diperlukan

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/h3.1/text-to-3d",
  "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": 200,
    "usd": "0.20",
    "charged": 200,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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
    },
    "model_urls": {
      "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
      },
      "fbx": {
        "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
      },
      "base_model": {
        "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
      },
      "pbr_model": {
        "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
      }
    },
    "rendered_image": {
      "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
    },
    "task_id": "string"
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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 GLB atau FBX yang mengandungi model 3D yang dijana, dengan format ditentukan oleh hasil keluaran Tripo.
model_urls
object {glb, fbx, base_model, pbr_model}URL yang menunjuk kepada versi alternatif model 3D.
rendered_image
object {url, content_type, file_name, file_size} | nullPratonton yang dirender untuk menunjukkan model 3D yang dijana.
task_id
string | nullID tugas Tripo yang boleh digunakan semula untuk mengenal pasti model yang dijana bagi rig atau rig-check, membolehkan operasi tersebut tanpa memuat naik model sekali lagi.

Lebih banyak model: Teks ke 3D

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/tripo3d/h3.1/text-to-3d.md. Semua model dan panduan: https://doitong.com/developers/llms.txt