İçeriğe geç

Tripo H3.1 Image to 3D

Entegre et

Model kimliği tripo3d/h3.1/image-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/image-to-3d?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Örnekteki gibi dosyalar: $0,30 300 API kredisi · ≈ ₽32,27 dosyalarınız çalıştırmadan önce ölçülür Bu sayfada çalıştır

API anahtarı al
Tripo Görselden 3D'ye #3d#image-to-3d#3d-generation#tripo

PBR materyalleri, dörtgen poligon ağları ve yüz sayısı denetimine sahip tek görselden 3D üretim

Tripo · 3D

İlk sonucunuz burada görünecek

Aşağıda bir istek oluşturun ve API anahtarınızla çalıştırın. Çıktılar depolamamıza kopyalanır ve sonsuza kadar veya ücretsiz olarak 7 gün boyunca saklanır.

İstek oluştur

Kontroller model şemasından oluşturulur. Değerleri değiştirdikçe kod ve fiyat güncellenir.

•gerekli image_url
Dosyayı bırakın veya

3D model oluşturmak için kullanılan girdi görsel URL'si.

texture_quality varsayılan standard

Doku kalitesi ayarı; 'detailed' seçildiğinde doku çözünürlüğü artar.

geometry_quality varsayılan standard

Geometri için kalite ayarı.

Gelişmiş texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment varsayılan original_image

Doku hizalama referansı: üretilen geometri için 'geometry', girdi görseli için 'original_image' kullanın.

orientation varsayılan default

Modelin yönü; 'align_image', modeli girdi görseliyle eşleşecek şekilde otomatik olarak döndürür.

Sağlandığında modelin uyarlamalı sayı seçimini geçersiz kılan, mesh üretimi için açık köşe sayısı hedefi.

Geometri üretiminin yeniden üretilebilir olmasını sağlayan tohum.

Doku üretiminin yeniden üretilebilir olmasını sağlayan tohum.

POST /run/tripo3d/h3.1/image-to-3d?wait=20 fiyat → $0,30
# 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/image-to-3d?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Bu isteği çalıştır

Anahtarınız bu tarayıcıda kalır: yalnızca Doitong API'ye gönderilir ve yalnızca Hatırla seçeneğini işaretlerseniz localStorage'a kaydedilir. API anahtarı al

Tripo H3.1 Image to 3D hakkında

`image_url` adresindeki tek görselden bir 3D model oluşturur. Seçenekler arasında `face_limit` (1,000 ile 2,000,000), `texture`, `pbr`, standart veya ayrıntılı `texture_quality` ve `geometry_quality`, `quad` topolojisi, `auto_size` ve `orientation` bulunur. Sonuç, bir ön izleme işlemesi ve sonraki iskelet oluşturma için bir görev kimliği içerir.

Parametreler

Kanonik adı veya yerel adı gönderin; ikisini birden göndermeyin. Kanonik adlar

AdTür Varsayılanİzin verilen Açıklama
image_urlgerekli image
Türurl · image
3D model oluşturmak için kullanılan girdi görsel URL'si.
face_limitisteğe bağlı
Türinteger | null
1.000 – 2.000.000
Sağlandığında modelin uyarlamalı sayı seçimini geçersiz kılan, mesh üretimi için açık köşe sayısı hedefi.
textureisteğe bağlı
Türboolean
Varsayılantrue
Modelin üretilen dokuları alıp almayacağını belirler.
pbristeğe bağlı
Türboolean
Varsayılantrue
PBR malzemelerini (Fizik Tabanlı İşleme) etkinleştirir; true olduğunda doku üretimini de açar.
model_seedisteğe bağlı
Türinteger | null
Geometri üretiminin yeniden üretilebilir olmasını sağlayan tohum.
texture_seedisteğe bağlı
Türinteger | null
Doku üretiminin yeniden üretilebilir olmasını sağlayan tohum.
texture_qualityisteğe bağlı
Türenum
Varsayılanstandard
standarddetailed
Doku kalitesi ayarı; 'detailed' seçildiğinde doku çözünürlüğü artar.
geometry_qualityisteğe bağlı
Türenum
Varsayılanstandard
standarddetailed
Geometri için kalite ayarı.
texture_alignmentisteğe bağlı
Türenum
Varsayılanoriginal_image
original_imagegeometry
Doku hizalama referansı: üretilen geometri için 'geometry', girdi görseli için 'original_image' kullanın.
auto_sizeisteğe bağlı
Türboolean
Varsayılanfalse
Modele metre cinsinden gerçek dünya boyutları vermek için otomatik ölçeklendirme.
orientationisteğe bağlı
Türenum
Varsayılandefault
defaultalign_image
Modelin yönü; 'align_image', modeli girdi görseliyle eşleşecek şekilde otomatik olarak döndürür.
quadisteğe bağlı
Türboolean
Varsayılanfalse
Quad topolojisini etkinleştirerek üçgen yüzler ile 4 kenarlı dörtgenler arasında seçim yapın. Quad sonuçları için Tripo verileri FBX baytları olarak sağladığında bir FBX dosyası döndürülür.
enable_safety_checkeristeğe bağlı
Türboolean
Varsayılantrue
Çağıran yetkiliyse false ayarlanarak tarama gevşetilebilir.
gerekli Kanonik ad, bu ad da kabul edilir

Dosya parametreleri herkese açık bir https:// URL'si, 10 MB'a kadar bir data: URI'si veya yüklenen bir dosyanın file_url değerini kabul eder. Dosyalar

Çıktı

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/h3.1/image-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": 300,
    "usd": "0.30",
    "charged": 300,
    "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
    },
    "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"
  }
}
Dosyalarınız, seçiminizHer outputs[].url, depolamamızdaki bir kopyadır: sonsuza kadar (GB-ay başına ücretli) veya ücretsiz olarak 7 gün boyunca, hesap ayarınızla ya da ?storage= ile saklanır.
Her modelde aynı yapıGörüntüler, video ve ses için type, url, content_type, width, height ve duration aynıdır. output, modelin kendi sonuç nesnesidir.
Çıktı alanları
model_mesh
object {url, content_type, file_name, file_size}Üretilen 3D modeli içeren GLB veya FBX dosyası; biçim, Tripo'nun ürettiğine göre belirlenir.
model_urls
object {glb, fbx, base_model, pbr_model}3D modelin alternatif sürümlerine işaret eden URL'ler.
rendered_image
object {url, content_type, file_name, file_size} | nullÜretilen 3D modeli gösteren işlenmiş önizleme.
task_id
string | nullÜretilen modeli tanımlayan, rig veya rig-check işlemlerinde yeniden kullanılabilen Tripo görev kimliği; bu işlemlerin başka bir model yüklemeden yapılmasını sağlar.

Daha fazla model: Görselden 3D'ye

AI aracıları için: bu sayfanın Markdown biçimi şurada: https://doitong.com/tr/developers/models/tripo3d/h3.1/image-to-3d.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt