Pereiti prie turinio

Sam 3 · 3D Align

Integruoti

Modelio id 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Ši užklausa: ≈0,02 $ 20 API kreditų · ≈ 2,11 ₽ Paleisti šiame puslapyje

Gauti API raktą
Meta · 3D

Čia bus pirmasis jūsų rezultatas

Sukurkite užklausą toliau ir paleiskite ją naudodami savo API raktą. Išvestys nukopijuojamos į mūsų saugyklą ir saugomos neribotą laiką arba 7 dienos nemokamai.

Sukurti užklausą

Valdikliai sugeneruojami pagal modelio schemą. Keisdami juos atnaujinsite kodą ir kainą.

•privaloma image_url
Įmeskite failą arba

Šaltinio vaizdo URL gylio įvertinimui naudojant MoGe.

•privaloma

Lygiavimo tinklo URL; priimamas SAM-3D Body failas .ply arba .glb formatu.

Išplėstiniai body_mask_url · object_mesh_url · focal_length
Įmeskite failą arba

Žmogaus kaukės vaizdo URL; jo nepateikus naudojamas visas vaizdas.

Pasirinktinis SAM-3D Object tinklo URL .glb formatu, naudojamas bendrai scenai sukurti.

Židinio nuotolio reikšmė iš SAM-3D Body metaduomenų; jei reikšmė nepateikta, naudojamas MoGe įvertis.

POST /run/sam-3/3d-align?wait=20 kaina → 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-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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Vykdyti šią užklausą

Jūsų raktas lieka šioje naršyklėje: jis siunčiamas tik į Doitong API ir išsaugomas (localStorage) tik pažymėjus Prisiminti. Gauti API raktą

Apie Sam 3 · 3D Align

Įkelia žmogaus kūno tinklelį (.ply arba .glb) į originalios nuotraukos koordinačių erdvę, naudodamas gylio įvertį iš `image_url`. Pasirinktiniai įvesties duomenys: žmogaus kaukė, židinio nuotolio reikšmė ir objekto tinklelis (.glb), leidžiantis gauti bendrą scenos failą. Išvestyje pateikiami sulygiuoti PLY ir GLB tinkleliai, lygiavimo metaduomenys ir perdangos vizualizacija.

Parametrai

Siųskite arba kanoninį, arba savąjį pavadinimą, bet ne abu. Kanoniniai pavadinimai

PavadinimasTipas Numatytoji reikšmėLeidžiama Aprašas
image_urlprivaloma image
Tipasurl · image
Šaltinio vaizdo URL gylio įvertinimui naudojant MoGe.
body_mesh_urlprivaloma
Tipasstring
Lygiavimo tinklo URL; priimamas SAM-3D Body failas .ply arba .glb formatu.
body_mask_urlneprivalomas
Tipasurl · image
Žmogaus kaukės vaizdo URL; jo nepateikus naudojamas visas vaizdas.
object_mesh_urlneprivalomas
Tipasstring | null
Pasirinktinis SAM-3D Object tinklo URL .glb formatu, naudojamas bendrai scenai sukurti.
focal_lengthneprivalomas
Tipasnumber | null
Židinio nuotolio reikšmė iš SAM-3D Body metaduomenų; jei reikšmė nepateikta, naudojamas MoGe įvertis.
privaloma Kanoninis pavadinimas, taip pat priimamas

Failų parametrams reikia viešo https:// URL, ne didesnio nei 10 MB data: URI arba įkelto failo file_url. Failai

Išvestis

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Jūsų failai — jūsų pasirinkimasKiekvienas outputs[].url yra kopija mūsų saugykloje: saugoma neribotą laiką (mokama už GB per mėnesį) arba 7 dienos nemokamai, pagal paskyros nustatymą arba ?storage=.
Ta pati struktūra kiekviename modelyjetype, url, content_type, width, height ir duration taikomi vaizdams, vaizdo įrašams ir garsui. output yra paties modelio rezultatų objektas.
Išvesties laukai
body_mesh_ply
object {url, content_type, file_name, file_size}PLY failas su sulygiuotu kūno tinklu.
model_glb
object {url, content_type, file_name, file_size}GLB failas su sulygiuotu kūno tinklu 3D peržiūrai.
visualization
object {url, content_type, file_name, file_size}Įvesties vaizdo vizualizacija su uždėtu sulygiuotu tinklu.
metadata
object {person_id, scale_factor, translation, focal_length, target_points_count, cropped_vertices_count}Lygiavimo informacija, pvz., mastelis ir poslinkis.
scene_glb
object {url, content_type, file_name, file_size} | nullGLB išvestis galima tik pateikus object_mesh_url; joje kūno ir objekto tinklai sujungti vienoje scenoje.

Daugiau modelių: 3D

AI agentams: šis puslapis Markdown formatu pateikiamas adresu https://doitong.com/lt/developers/models/sam-3/3d-align.md. Visi modeliai ir vadovai: https://doitong.com/developers/llms.txt