İçeriğe geç

Tripo3D · Image to 3D

Entegre et

Model kimliği tripo3d/tripo/v2.5/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/tripo/v2.5/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,19 dosyalarınız çalıştırmadan önce ölçülür Bu sayfada çalıştır

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

Stil ön ayarları, HD doku, quad çıktısı ve hizalama seçenekleriyle görüntüden 3D'ye (v2.5)

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

Modeli üretmek için kullanılan görsel URL'si.

texture varsayılan standard

Model için doku ayarı: 'standard' varsayılandır, 'no' dokuları devre dışı bırakır ve 'HD' yüksek çözünürlüklü dokular üretir.

Stil ayarı; özgün görünüm ve stili korumak için belirtilmeden bırakın.

Gelişmiş texture_alignment · orientation · face_limit · seed · texture_seed · pbr · auto_size
texture_alignment varsayılan original_image

Bir 3D model için doku hizalama önceliği ayarı; başka bir değer sağlanmadığında original_image kullanılır.

orientation varsayılan default

Model yönü, başlangıçta `default` olarak ayarlanır. Modeli özgün görselle otomatik olarak hizalamak için `align_image` seçin.

Çıktı yüz sayısı sınırı; açık bir sınır sağlamadığınızda uyarlamalı olarak seçilir.

Geometri üretimini denetleyen tam sayı tohumu; yeniden kullanıldığında aynı modelleri üretir. Belirtilmezse rastgele bir değer seçilir.

Tam sayı olarak sağlanan veya belirtilmezse rastgele seçilen doku üretim tohumu. Aynı tohum değerleri aynı dokuları yeniden üretir; model tohumunu sabit tutarken modelin dokularını değiştirmek için texture_seed değerini değiştirin.

POST /run/tripo3d/tripo/v2.5/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/tripo/v2.5/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

Tripo3D · Image to 3D hakkında

Tek bir `image_url` üzerinden 3D model oluşturur. `texture`, isteğe bağlı PBR çıktısıyla birlikte no, standard veya HD olabilir. Clay, steampunk, gold veya ancient bronze gibi bir `style` ön ayarı sonucu yeniden biçimlendirebilir. Diğer kontroller arasında modeli görüntüyle hizalamak için `face_limit`, `quad` (FBX'i zorunlu kılar), `auto_size`, `texture_alignment` ve `orientation` bulunur.

Parametreler

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

AdTür Varsayılanİzin verilen Açıklama
seedisteğe bağlı
Türinteger | null
Geometri üretimini denetleyen tam sayı tohumu; yeniden kullanıldığında aynı modelleri üretir. Belirtilmezse rastgele bir değer seçilir.
face_limitisteğe bağlı
Türinteger | null
Çıktı yüz sayısı sınırı; açık bir sınır sağlamadığınızda uyarlamalı olarak seçilir.
pbristeğe bağlı
Türboolean | null
Varsayılanfalse
PBR anahtarı: False, PBR'siz bir model üretirken True doku ayarını geçersiz kılar ve onu True olarak işler. PBR varsayılan olarak etkindir.
textureisteğe bağlı
Türenum
Varsayılanstandard
nostandardHD
Model için doku ayarı: 'standard' varsayılandır, 'no' dokuları devre dışı bırakır ve 'HD' yüksek çözünürlüklü dokular üretir.
texture_seedisteğe bağlı
Türinteger | null
Tam sayı olarak sağlanan veya belirtilmezse rastgele seçilen doku üretim tohumu. Aynı tohum değerleri aynı dokuları yeniden üretir; model tohumunu sabit tutarken modelin dokularını değiştirmek için texture_seed değerini değiştirin.
auto_sizeisteğe bağlı
Türboolean | null
Varsayılanfalse
Varsayılan olarak devre dışı olan (False) ve metreleri kullanarak model boyutlarını otomatik ayarlayan gerçek dünya boyutlandırma anahtarı.
styleisteğe bağlı
Türenum
person:person2cartoonobject:clayobject:steampunkanimal:venomobject:barbieobject:christmasgoldancient_bronze
Stil ayarı; özgün görünüm ve stili korumak için belirtilmeden bırakın.
quadisteğe bağlı
Türboolean | null
Varsayılanfalse
Quad modu etkinleştirildiğinde FBX çıktısını zorunlu kılar. quad=True ve face_limit belirtilmemişse face_limit varsayılan olarak 10000 olur.
texture_alignmentisteğe bağlı
Türenum
Varsayılanoriginal_image
original_imagegeometry
Bir 3D model için doku hizalama önceliği ayarı; başka bir değer sağlanmadığında original_image kullanılır.
orientationisteğe bağlı
Türenum
Varsayılandefault
defaultalign_image
Model yönü, başlangıçta `default` olarak ayarlanır. Modeli özgün görselle otomatik olarak hizalamak için `align_image` seçin.
image_urlgerekli image
Türurl · image
Modeli üretmek için kullanılan görsel URL'si.
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/tripo/v2.5/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": {
    "task_id": "string",
    "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
    },
    "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
    }
  },
  "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ı
task_id
string3D modeli üretme görevinin tanımlayıcısı.
model_mesh
object {url, content_type, file_name, file_size} | nullModel çıktısı.
base_model
object {url, content_type, file_name, file_size} | nullTemel model çıktısı.
pbr_model
object {url, content_type, file_name, file_size} | nullPBR model çıktısı.
rendered_image
object {url, content_type, file_name, file_size} | nullModelin önizlemesini gösteren görsel.

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/tripo/v2.5/image-to-3d.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt