שפּרינגען צו אינהאַלט

Sam 3 · 3D Align

אינטעגרירן

מאָדעל־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"

דער דאָזיקער ריקוועסט: ≈⁨$ 0.02⁩ 20 API־קרעדיטן · ≈ ⁨₽ 2.11⁩ לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Meta 3D #align#3d

פּאַסט אַ SAM 3D גוף־מעש צו דער סצענע פֿון דער מקור־פֿאָטאָ, אָפּציאָנאַל צוזאַמענגעשטעלט מיט אַן אָביעקט־מעש

Meta · 3D

דאָ קומט אײַער ערשטער רעזולטאַט

בויט אונטן אַ בקשה און לויפט זי מיט אײַער API שליסל. רעזולטאַטן ווערן קאַפּירט צו אונדזער סטאָרידזש, געהאַלטן אויף אייביק אָדער 7 טעג אומזיסט.

בויען אַ בעטן

קאָנטראָלן ווערן דזשענערירט פֿון דעם מאָדעל־סכעמע. דער קאָד און דער פּרײַז דערהײַנטיקן זיך ווען איר ענדערט זיי.

•פארלאנגט image_url
לייגט אַרײַן אַ טעקע, אָדער

מקור־בילד־URL פֿאַר טיפֿקייט־אָפּשאַצונג מיט MoGe.

•פארלאנגט

נעץ־URL פֿאַר אויסריכטונג; נעמט אָן אַ SAM-3D Body־פֿײַל אין .ply אָדער .glb־פֿאָרמאַט.

פֿאָרגעשריטן body_mask_url · object_mesh_url · focal_length
לייגט אַרײַן אַ טעקע, אָדער

URL פֿון אַ מענטש־מאַסקע־בילד; אויב מען לאָזט עס אויס, ווערט גענוצט דאָס גאַנצע בילד.

אָפּציאָנעלער נעץ־URL פֿאַר אַ SAM-3D Object אין .glb־פֿאָרמאַט, גענוצט צו בויען אַ צונויפֿגעשטעלטע סצענע.

איבערשרײַבונג פֿון דער פֿאָקאַל־לענג פֿון SAM-3D Body־מעטאַדאַטן; אויב קיין ווערט ווערט נישט צוגעשטעלט, נוצט מען די MoGe־אָפּשאַצונג.

POST /run/sam-3/3d-align?wait=20 פּרײַז → ⁨$ 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"

לויפֿן דעם ריקוועסט

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן Sam 3 · 3D Align

שטעלט אַ מענטשלעכע קערפּער־מעש (.ply אָדער .glb) אין דעם קאָאָרדינאַטן־רוימען פֿון דער אָריגינעלער פאָטאָ, מיט טיפקייַט־אויסרעכענונג פֿון `image_url`. אָפּציאָנאַלע אַרײַנקומענישן זענען אַ מענטשלעכע מאַסקע, אַ פֿאָקאַל־לענג־ווערט און אַן אָביעקט־מעש (.glb), וואָס גיט אַ קאָמבינירטע סצענע־טעקע. די רעזולטאַטן אַרײַננעמען אויסגעגליכענע מעשעס אין PLY און GLB, אויסגלײַכונג־מעטאַדאַטן און אַן איבערלייג־וויזואַליזאַציע.

פּאַראַמעטערס

שיקט אָדער דעם קאַנאָנישן נאָמען אָדער דעם נאַטיוון נאָמען, נישט ביידע. קאַנאָנישע נעמען

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
image_urlפארלאנגט image
טיפּurl · image
מקור־בילד־URL פֿאַר טיפֿקייט־אָפּשאַצונג מיט MoGe.
body_mesh_urlפארלאנגט
טיפּstring
נעץ־URL פֿאַר אויסריכטונג; נעמט אָן אַ SAM-3D Body־פֿײַל אין .ply אָדער .glb־פֿאָרמאַט.
body_mask_urlאָפּציאָנעל
טיפּurl · image
URL פֿון אַ מענטש־מאַסקע־בילד; אויב מען לאָזט עס אויס, ווערט גענוצט דאָס גאַנצע בילד.
object_mesh_urlאָפּציאָנעל
טיפּstring | null
אָפּציאָנעלער נעץ־URL פֿאַר אַ SAM-3D Object אין .glb־פֿאָרמאַט, גענוצט צו בויען אַ צונויפֿגעשטעלטע סצענע.
focal_lengthאָפּציאָנעל
טיפּnumber | null
איבערשרײַבונג פֿון דער פֿאָקאַל־לענג פֿון SAM-3D Body־מעטאַדאַטן; אויב קיין ווערט ווערט נישט צוגעשטעלט, נוצט מען די MoGe־אָפּשאַצונג.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 10 MB, אָדער דעם file_url פֿון אַן אַרויפֿלאָד. טעקעס

אויסגאַבע

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"
  }
}
אייער טעקעס, אייער ברירהיעדער outputs[].url איז אַ קאַפּיע אין אונדזער סטאָרידזש: געהאַלטן אויף אייביק (באַצאָלט פּער GB־חודש) אָדער 7 טעג אומזיסט, לויט אײַער חשבון־באַשטעטיקונג אָדער ?storage=.
דער זעלבער פֿאָרעם בײַ יעדן מאָדעלtype, url, content_type, width, height און duration, סײַ פֿאַר בילדער, ווידעאָ און אַודיאָ. output איז דער אייגענער רעזולטאַט־אָביעקט פֿון מאָדעל.
פֿעלדער פֿון דער אויסגאַבע
body_mesh_ply
object {url, content_type, file_name, file_size}PLY־פֿײַל מיט דער אויסגעריכטער קערפּער־נעץ.
model_glb
object {url, content_type, file_name, file_size}GLB־פֿײַל מיט דער אויסגעריכטער קערפּער־נעץ פֿאַר אַ 3D־פֿאָרויסקוק.
visualization
object {url, content_type, file_name, file_size}וויזואַליזאַציע פֿונעם אַרײַנגעבונג־בילד מיט דער אויסגעריכטער נעץ דערויף.
metadata
object {person_id, scale_factor, translation, focal_length, target_points_count, cropped_vertices_count}אויסריכטונג־פּרטים, ווי מאָסשטאַב און פֿאַרשיבונג.
scene_glb
object {url, content_type, file_name, file_size} | nullGLB־רעזולטאַט בנימצא נאָר ווען object_mesh_url ווערט צוגעשטעלט; ער אַנטהאַלט די קערפּער־ און אָביעקט־נעצן צוזאַמען אין איין סצענע.

מער מאָדעלן: 3D

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/sam-3/3d-align.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt