İçeriğe geç

Sam 3 · 3D Objects

Entegre et

Model kimliği sam-3/3d-objects
# 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/sam-3/3d-objects?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 istek: ≈$0,02 20 API kredisi · ≈ ₽2,11 Bu sayfada çalıştır

API anahtarı al
Meta Görselden 3D'ye #3d#object

Metin, nokta veya kutu istemleri ya da maskelerle seçilen nesneleri, splat çıktısıyla görüntüden 3D olarak yeniden oluşturur

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

varsayılan car

Maskeler yoksa otomatik segmentasyon için kullanılan metin; örneğin 'chair' veya 'lamp'.

•gerekli image_url
Dosyayı bırakın veya

3D yeniden yapılandırma için görsel URL'si.

Gelişmiş mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Dosyayı bırakın veya

Her nesne için isteğe bağlı maske URL'leri listesi. Maskeler olmadığında otomatik segmentasyon, sağlanmışsa istem, point_prompts veya box_prompts kullanır; ne maskeler ne de segmentasyon istemleri sağlanmışsa görselin tamamı kullanılır.

NPY veya NPZ olarak harici pointmap ya da derinlik verileri sağlayarak 3D yeniden yapılandırmada derinlik tahminini iyileştirmek için isteğe bağlı URL.

Belirtilmezse modelin varsayılanına bırakılan algılama güven eşiği. Değerler 0.1 ile 1.0 arasındadır; daha küçük değerler, algılama sayısını artırırken kesinlikten ödün verir.

Tekrarlanabilir rastgele üretim için kullanılan tohum.

varsayılan []

Maskeler yoksa otomatik segmentasyon için kullanılan nokta tabanlı istemler.

varsayılan []

Otomatik segmentasyon yoluyla 3D yeniden yapılandırma için ayrı nesne maskeleri üreten kutu istemleri; yalnızca maske sağlanmadığında kullanılır. Birden fazla kutu gönderilebilir.

POST /run/sam-3/3d-objects?wait=20 fiyat → $0,02
# 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/sam-3/3d-objects?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

Sam 3 · 3D Objects hakkında

Fotoğraflardaki nesneleri 3D varlıklara dönüştürür. Nesneleri `mask_urls`, metin `prompt`, `point_prompts` veya `box_prompts` ile seçin; birden çok kutu ayrı nesneler oluşturur. `detection_threshold` 0.1 ile 1 arasını kabul eder ve `export_textured_glb`, doku ile UV'leri gömer. Bir GLB, Gaussian splat dosyaları, çok nesneli sahneler için nesne başına dosyalar, meta veriler ve bir zip paketi çıktılanır.

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 yeniden yapılandırma için görsel URL'si.
mask_urlsisteğe bağlı
Türurl[] · image
Her nesne için isteğe bağlı maske URL'leri listesi. Maskeler olmadığında otomatik segmentasyon, sağlanmışsa istem, point_prompts veya box_prompts kullanır; ne maskeler ne de segmentasyon istemleri sağlanmışsa görselin tamamı kullanılır.
promptisteğe bağlı
Türstring | null
Varsayılancar
Maskeler yoksa otomatik segmentasyon için kullanılan metin; örneğin 'chair' veya 'lamp'.
point_promptsisteğe bağlı
Türobject[]
Varsayılan[]
Maskeler yoksa otomatik segmentasyon için kullanılan nokta tabanlı istemler.
point_prompts[].xisteğe bağlı
Türinteger | null
İstemin X ekseni üzerindeki konumu.
point_prompts[].yisteğe bağlı
Türinteger | null
İstemin Y ekseni üzerindeki konumu.
point_prompts[].labelisteğe bağlı
Türenum
01
Ön plan/arka plan etiketi: 1 ön planı, 0 arka planı belirtir.
point_prompts[].object_idisteğe bağlı
Türinteger | null
Tek bir nesneyi iyileştiren istemleri gruplandıran isteğe bağlı tanımlayıcı. Metin de istem olarak sağlanırsa bu tanımlayıcı, noktaların hangi algılanan nesneyi iyileştireceğini belirler.
box_promptsisteğe bağlı
Türobject[]
Varsayılan[]
Otomatik segmentasyon yoluyla 3D yeniden yapılandırma için ayrı nesne maskeleri üreten kutu istemleri; yalnızca maske sağlanmadığında kullanılır. Birden fazla kutu gönderilebilir.
box_prompts[].x_ministeğe bağlı
Türinteger | null
Kutunun minimum x koordinatı.
box_prompts[].y_ministeğe bağlı
Türinteger | null
Kutunun minimum y koordinatı.
box_prompts[].x_maxisteğe bağlı
Türinteger | null
Kutu için maksimum X koordinatı.
box_prompts[].y_maxisteğe bağlı
Türinteger | null
Kutu için maksimum Y koordinatı.
box_prompts[].object_idisteğe bağlı
Türinteger | null
Tek bir nesneyi iyileştiren kutuları gruplandıran isteğe bağlı tanımlayıcı.
seedisteğe bağlı
Türinteger | null
Tekrarlanabilir rastgele üretim için kullanılan tohum.
pointmap_urlisteğe bağlı
Türstring | null
NPY veya NPZ olarak harici pointmap ya da derinlik verileri sağlayarak 3D yeniden yapılandırmada derinlik tahminini iyileştirmek için isteğe bağlı URL.
detection_thresholdisteğe bağlı
Türnumber | null
0,1 – 1
Belirtilmezse modelin varsayılanına bırakılan algılama güven eşiği. Değerler 0.1 ile 1.0 arasındadır; daha küçük değerler, algılama sayısını artırırken kesinlikten ödün verir.
export_textured_glbisteğe bağlı
Türboolean
Varsayılanfalse
GLB dışa aktarma seçeneği: bu seçenek etkinleştirildiğinde tepe renkleri pişirilmiş doku ve UV'lerle değiştirilir.
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": "sam-3/3d-objects",
  "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": {
    "gaussian_splat": {
      "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_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
    },
    "metadata": [
      {
        "object_index": 1,
        "scale": [
          []
        ],
        "rotation": [
          []
        ],
        "translation": [
          []
        ],
        "camera_pose": [
          []
        ]
      }
    ],
    "individual_splats": [
      {
        "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
      }
    ],
    "individual_glbs": [
      {
        "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
      }
    ],
    "artifacts_zip": {
      "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ı
gaussian_splat
object {url, content_type, file_name, file_size}Birden fazla nesne içeren sonuçlar için birleşik sahne splat'i, aksi durumda tek bir splat; .ply formatında Gaussian splat dosyası olarak sağlanır.
model_glb
object {url, content_type, file_name, file_size}GLB olarak kaydedilen 3D çıktı: birden fazla nesne tek sahnede birleştirilir, diğer sonuçlar ise tek mesh içerir.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Döndürme, öteleme ve ölçek dahil her nesne için meta veriler.
individual_splats
array of object {url, content_type, file_name, file_size} | nullHer nesne için ayrı Gaussian splat dosyaları; yalnızca birden fazla nesne içeren sahnelerde kullanılabilir.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullHer nesne için ayrı GLB mesh dosyaları; yalnızca birden fazla nesne içeren sahnelerde kullanılabilir.
artifacts_zip
object {url, content_type, file_name, file_size} | nullTüm yapıtların ve meta verilerin ZIP arşivi.

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