Přejít na obsah

Sam 3 · 3D Objects

Integrace

ID modelu 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"

Tento požadavek: ≈0,02 $ 20 kreditů API · ≈ 2,11 ₽ Spustit na této stránce

Získat API klíč
Meta Obrázek na 3D #3d#object

Rekonstruuje 3D objekty z obrázku vybrané textem, body, obdélníky nebo maskami, s výstupem ve formě splatů

Meta · 3D

Zde se zobrazí váš první výsledek

Níže sestavte požadavek a spusťte ho pomocí svého API klíče. Výstupy se kopírují do našeho úložiště a uchovávají se navždy nebo 7 dne zdarma.

Sestavit požadavek

Ovládací prvky se generují ze schématu modelu. Kód a cena se aktualizují podle provedených změn.

výchozí car

Text použitý pro automatickou segmentaci, pokud masky chybí, například 'chair' nebo 'lamp'.

•povinné image_url
Přetáhněte soubor nebo

URL obrázku pro 3D rekonstrukci.

Pokročilé mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Přetáhněte soubor nebo

Volitelný seznam URL masek pro jednotlivé objekty. Bez masek použije automatická segmentace prompt, point_prompts nebo box_prompts, pokud jsou zadány; pokud nejsou zadány ani masky, ani prompty segmentace, použije se celý obrázek.

Volitelná URL pro zlepšení odhadu hloubky při 3D rekonstrukci dodáním externích dat pointmap nebo hloubky jako NPY nebo NPZ.

Prahová hodnota spolehlivosti detekce; při vynechání se použije výchozí hodnota modelu. Hodnoty jsou v rozsahu 0.1 až 1.0, přičemž nižší hodnoty směňují přesnost za vyšší počet detekcí.

Seed použitý pro reprodukovatelné náhodné generování.

výchozí []

Bodové prompty použité pro automatickou segmentaci, pokud masky chybí.

výchozí []

Prompty rámečků vytvářející jednotlivé masky objektů pro 3D rekonstrukci pomocí automatické segmentace; použijí se pouze tehdy, pokud nejsou zadány masky. Lze odeslat více rámečků.

POST /run/sam-3/3d-objects?wait=20 cena → 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"

Spustit tento požadavek

Váš klíč zůstává v tomto prohlížeči: odesílá se pouze do Doitong API a uloží se do localStorage jen tehdy, když zaškrtnete možnost Zapamatovat. Získat klíč API

O modelu Sam 3 · 3D Objects

Mění objekty na fotografii na 3D assety. Objekty vyberete pomocí `mask_urls`, textu `prompt`, `point_prompts` nebo `box_prompts`; více obdélníků vytvoří samostatné objekty. `detection_threshold` přijímá hodnoty od 0.1 do 1 a `export_textured_glb` zapéká texturu a UV souřadnice. Výstupy tvoří GLB, soubory Gaussian splatů, soubory pro jednotlivé objekty u scén s více objekty, metadata a balíček zip.

Parametry

Odešlete buď kanonický název, nebo nativní název, ne oba. Kanonické názvy

NázevTyp VýchozíPovolené Popis
image_urlpovinné image
Typurl · image
URL obrázku pro 3D rekonstrukci.
mask_urlsvolitelné
Typurl[] · image
Volitelný seznam URL masek pro jednotlivé objekty. Bez masek použije automatická segmentace prompt, point_prompts nebo box_prompts, pokud jsou zadány; pokud nejsou zadány ani masky, ani prompty segmentace, použije se celý obrázek.
promptvolitelné
Typstring | null
Výchozícar
Text použitý pro automatickou segmentaci, pokud masky chybí, například 'chair' nebo 'lamp'.
point_promptsvolitelné
Typobject[]
Výchozí[]
Bodové prompty použité pro automatickou segmentaci, pokud masky chybí.
point_prompts[].xvolitelné
Typinteger | null
Pozice promptu na ose X.
point_prompts[].yvolitelné
Typinteger | null
Pozice promptu na ose Y.
point_prompts[].labelvolitelné
Typenum
01
Štítek popředí/pozadí: 1 označuje popředí, 0 označuje pozadí.
point_prompts[].object_idvolitelné
Typinteger | null
Volitelný identifikátor seskupující prompty, které zpřesňují jeden objekt. Pokud je jako prompt zadán také text, tento identifikátor určuje, který detekovaný objekt tyto body zpřesňují.
box_promptsvolitelné
Typobject[]
Výchozí[]
Prompty rámečků vytvářející jednotlivé masky objektů pro 3D rekonstrukci pomocí automatické segmentace; použijí se pouze tehdy, pokud nejsou zadány masky. Lze odeslat více rámečků.
box_prompts[].x_minvolitelné
Typinteger | null
Minimální souřadnice x rámečku.
box_prompts[].y_minvolitelné
Typinteger | null
Minimální souřadnice y rámečku.
box_prompts[].x_maxvolitelné
Typinteger | null
Maximální souřadnice X rámečku.
box_prompts[].y_maxvolitelné
Typinteger | null
Maximální souřadnice Y rámečku.
box_prompts[].object_idvolitelné
Typinteger | null
Volitelný identifikátor seskupující rámečky, které zpřesňují jeden objekt.
seedvolitelné
Typinteger | null
Seed použitý pro reprodukovatelné náhodné generování.
pointmap_urlvolitelné
Typstring | null
Volitelná URL pro zlepšení odhadu hloubky při 3D rekonstrukci dodáním externích dat pointmap nebo hloubky jako NPY nebo NPZ.
detection_thresholdvolitelné
Typnumber | null
0,1 – 1
Prahová hodnota spolehlivosti detekce; při vynechání se použije výchozí hodnota modelu. Hodnoty jsou v rozsahu 0.1 až 1.0, přičemž nižší hodnoty směňují přesnost za vyšší počet detekcí.
export_textured_glbvolitelné
Typboolean
Výchozífalse
Volba exportu GLB: zapnutím této možnosti se barvy vrcholů nahradí předem vypočtenou texturou a UV souřadnicemi.
povinné Kanonický název, také podporován

Parametry souborů přijímají veřejnou adresu https:// URL, data: URI do 10 MB nebo file_url nahraného souboru. Soubory

Výstup

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"
  }
}
Vaše soubory, vaše volbaKaždý outputs[].url je kopie v našem úložišti: uchovávaná navždy (zpoplatněná za GB-měsíc) nebo 7 dne zdarma podle nastavení účtu nebo ?storage=.
Stejná struktura u každého modelutype, url, content_type, width, height a duration pro obrázky, video i zvuk. output je vlastní objekt výsledku modelu.
Pole výstupu
gaussian_splat
object {url, content_type, file_name, file_size}Kombinovaný splat scény pro výsledky s více objekty, jinak jediný splat; dodává se jako soubor Gaussian splat ve formátu .ply.
model_glb
object {url, content_type, file_name, file_size}3D výstup uložený jako GLB: více objektů se sestaví do jedné scény, zatímco ostatní výsledky obsahují jednu síť.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Metadata pro každý objekt včetně rotace, posunu a měřítka.
individual_splats
array of object {url, content_type, file_name, file_size} | nullSamostatné soubory Gaussian splat pro každý objekt, dostupné pouze ve scénách s více objekty.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullSamostatné soubory sítě GLB pro každý objekt, dostupné pouze ve scénách s více objekty.
artifacts_zip
object {url, content_type, file_name, file_size} | nullZIP archiv všech artefaktů a metadat.

Další modely: Obrázek na 3D

Pro AI agenty: tato stránka je ve formátu Markdown na adrese https://doitong.com/cs/developers/models/sam-3/3d-objects.md. Všechny modely a návody: https://doitong.com/developers/llms.txt