İçeriğe geç

Sam 3 · 3D Align

Entegre et

Model kimliği sam-3/3d-align
# 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/sam-3/3d-align?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",
    "body_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"

Bu istek: ≈$0,02 20 API kredisi Bu sayfada çalıştır

API anahtarı al
Meta 3D #align#3d

SAM 3D gövde ağını kaynak fotoğrafın sahnesine hizalar ve isteğe bağlı olarak bir nesne ağıyla birleştirir

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.

•gerekli image_url
Dosyayı bırakın veya

MoGe ile derinlik tahmini için kaynak görsel URL'si.

•gerekli

Hizalama için, .ply veya .glb formatında SAM-3D Body dosyasını kabul eden mesh URL'si.

Gelişmiş body_mask_url · object_mesh_url · focal_length
Dosyayı bırakın veya

İnsan maskesi görsel URL'si; belirtilmezse görselin tamamı kullanılır.

Birleşik sahne oluşturmak için kullanılan SAM-3D Object için isteğe bağlı .glb formatında mesh URL'si.

SAM-3D Body meta verilerinden alınan odak uzaklığı geçersiz kılma değeri; değer sağlanmazsa MoGe tahmini kullanılır.

POST /run/sam-3/3d-align?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.com/v1/run/sam-3/3d-align?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",
    "body_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"

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 Align hakkında

`image_url` üzerinden derinlik tahmini kullanarak bir insan vücudu poligon ağını (.ply veya .glb) özgün fotoğrafın koordinat alanına yerleştirir. İsteğe bağlı girdiler insan maskesi, odak uzaklığı değeri ve birleşik bir sahne dosyası üreten nesne poligon ağıdır (.glb). Çıktılar arasında PLY ve GLB biçiminde hizalanmış poligon ağları, hizalama meta verileri ve bindirme görselleştirmesi bulunur.

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
MoGe ile derinlik tahmini için kaynak görsel URL'si.
body_mesh_urlgerekli
Türstring
Hizalama için, .ply veya .glb formatında SAM-3D Body dosyasını kabul eden mesh URL'si.
body_mask_urlisteğe bağlı
Türurl · image
İnsan maskesi görsel URL'si; belirtilmezse görselin tamamı kullanılır.
object_mesh_urlisteğe bağlı
Türstring | null
Birleşik sahne oluşturmak için kullanılan SAM-3D Object için isteğe bağlı .glb formatında mesh URL'si.
focal_lengthisteğe bağlı
Türnumber | null
SAM-3D Body meta verilerinden alınan odak uzaklığı geçersiz kılma değeri; değer sağlanmazsa MoGe tahmini kullanılır.
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-align",
  "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",
    "body_mesh_url": "https://example.com/your-file.glb"
  },
  "output": {
    "body_mesh_ply": {
      "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
    },
    "visualization": {
      "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": {
      "person_id": 1,
      "scale_factor": 1.0,
      "translation": [
        1.0
      ],
      "focal_length": 1.0,
      "target_points_count": 1,
      "cropped_vertices_count": 1
    },
    "scene_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
    }
  },
  "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"
  }
}
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ı
body_mesh_ply
object {url, content_type, file_name, file_size}Hizalanmış gövde mesh'ini içeren PLY dosyası.
model_glb
object {url, content_type, file_name, file_size}3D önizleme için hizalanmış gövde mesh'ini içeren GLB dosyası.
visualization
object {url, content_type, file_name, file_size}Hizalanmış mesh üst üste bindirilmiş girdi görseli görselleştirmesi.
metadata
object {person_id, scale_factor, translation, focal_length, target_points_count, cropped_vertices_count}Ölçek ve öteleme gibi hizalama ayrıntıları.
scene_glb
object {url, content_type, file_name, file_size} | nullYalnızca object_mesh_url sağlandığında kullanılabilen GLB çıktısı; gövde ve nesne mesh'lerini tek sahnede birlikte içerir.

Daha fazla model: 3D

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