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

Sam 3 · 3D Objects

אינטעגרירן

מאָדעל־id 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

קאָנסטרויִרט 3D אָביעקטן פֿון אַ בילד, אויסגעקליבן דורך טעקסט־, פּונקט־ אָדער קעסטל־פּראָמפּטן אָדער מאַסקעס, מיט splat־רעזולטאַט

Meta · 3D

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

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

בויען אַ בעטן

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

סטאַנדאַרט car

טעקסט פֿאַר אויטאָמאַטישער סעגמענטאַציע ווען עס פֿעלן מאַסקעס, למשל 'chair' אָדער 'lamp'.

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

בילד־URL פֿאַר 3D־רעקאָנסטרוקציע.

פֿאָרגעשריטן mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
לייגט אַרײַן אַ טעקע, אָדער

אָפּציאָנעלע רשימה פֿון מאַסקע־URLs פֿאַר יעדן אָביעקט. אָן מאַסקעס נוצט אויטאָמאַטישע סעגמענטאַציע פּראָמפּט, point_prompts אָדער box_prompts, אויב צוגעשטעלט; אויב עס ווערן נישט צוגעשטעלט קיין מאַסקעס און קיין סעגמענטאַציע־פּראָמפּטן, ווערט גענוצט דאָס גאַנצע בילד.

אָפּציאָנעלער URL צו פֿאַרבעסערן טיפֿקייט־אָפּשאַצונג אין 3D־רעקאָנסטרוקציע דורך צושטעלן אויסערלעכע פּונקט־מאַפּע־ אָדער טיפֿקייט־דאַטן ווי NPY אָדער NPZ.

שוועל פֿאַר דער דערקענונגס־צוטרוי; בײַם אויסלאָזן ווערט גענוצט דער סטאַנדאַרט פֿונעם מאָדעל. די ווערטן גייען פֿון 0.1 ביז 1.0; קלענערע ווערטן פֿאַרגרעסערן די צאָל דערקענונגען אויפֿן חשבון פֿון פּינקטלעכקייט.

סיד גענוצט פֿאַר רעפּראָדוצירבאַרער טראַפֿישער גענערירונג.

סטאַנדאַרט []

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

סטאַנדאַרט []

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

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

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

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

וועגן Sam 3 · 3D Objects

מאַכט אָביעקטן אין אַ פֿאָטאָ צו 3D אַסעץ. קלײַבט אָביעקטן מיט `mask_urls`, אַ טעקסט־`prompt`, `point_prompts` אָדער `box_prompts`; מערערע קעסטלעך געבן באַזונדערע אָביעקטן. `detection_threshold` נעמט 0.1 ביז 1, און `export_textured_glb` באַקט אַרײַן טעקסטור און UVs. רעזולטאַטן זענען אַ GLB, Gaussian splat פֿײַלן, פֿײַלן פּער אָביעקט פֿאַר מולטי־אָביעקט סצענעס, מעטאַדאַטן און אַ zip פּעקל.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
image_urlפארלאנגט image
טיפּurl · image
בילד־URL פֿאַר 3D־רעקאָנסטרוקציע.
mask_urlsאָפּציאָנעל
טיפּurl[] · image
אָפּציאָנעלע רשימה פֿון מאַסקע־URLs פֿאַר יעדן אָביעקט. אָן מאַסקעס נוצט אויטאָמאַטישע סעגמענטאַציע פּראָמפּט, point_prompts אָדער box_prompts, אויב צוגעשטעלט; אויב עס ווערן נישט צוגעשטעלט קיין מאַסקעס און קיין סעגמענטאַציע־פּראָמפּטן, ווערט גענוצט דאָס גאַנצע בילד.
promptאָפּציאָנעל
טיפּstring | null
סטאַנדאַרטcar
טעקסט פֿאַר אויטאָמאַטישער סעגמענטאַציע ווען עס פֿעלן מאַסקעס, למשל 'chair' אָדער 'lamp'.
point_promptsאָפּציאָנעל
טיפּobject[]
סטאַנדאַרט[]
פּונקט־באַזירטע פּראָמפּטן פֿאַר אויטאָמאַטישער סעגמענטאַציע ווען עס פֿעלן מאַסקעס.
point_prompts[].xאָפּציאָנעל
טיפּinteger | null
פּראָמפּט־פּאָזיציע צוזאמען מיטן X־אַקס.
point_prompts[].yאָפּציאָנעל
טיפּinteger | null
פּראָמפּט־פּאָזיציע צוזאמען מיטן Y־אַקס.
point_prompts[].labelאָפּציאָנעל
טיפּenum
01
פֿאָרגרונט/הינטערגרונט־לאַבעל: 1 מיינט פֿאָרגרונט; 0 מיינט הינטערגרונט.
point_prompts[].object_idאָפּציאָנעל
טיפּinteger | null
אָפּציאָנעלע אידענטיפֿיקאַטאָר וואָס גרופּירט פּראָמפּטן פֿאַר איין אָביעקט. אויב טעקסט ווערט אויך צוגעשטעלט, באַשטימט דער אידענטיפֿיקאַטאָר וועלכן דערקענטן אָביעקט די פּונקטן פֿאַרבעסערן.
box_promptsאָפּציאָנעל
טיפּobject[]
סטאַנדאַרט[]
קעסטל־פּראָמפּטן וואָס שאַפֿן באַזונדערע אָביעקט־מאַסקעס פֿאַר 3D־רעקאָנסטרוקציע דורך אויטאָמאַטישער סעגמענטאַציע, גענוצט נאָר ווען קיין מאַסקעס ווערן נישט צוגעשטעלט. מען קען שיקן עטלעכע קעסטלעך.
box_prompts[].x_minאָפּציאָנעל
טיפּinteger | null
מינימאַלע x-קאָאָרדינאַט פֿאַרן קעסטל.
box_prompts[].y_minאָפּציאָנעל
טיפּinteger | null
מינימאַלע y-קאָאָרדינאַט פֿאַרן קעסטל.
box_prompts[].x_maxאָפּציאָנעל
טיפּinteger | null
מאַקסימום X־קאָאָרדינאַט פֿאַרן קעסטל.
box_prompts[].y_maxאָפּציאָנעל
טיפּinteger | null
מאַקסימום Y־קאָאָרדינאַט פֿאַרן קעסטל.
box_prompts[].object_idאָפּציאָנעל
טיפּinteger | null
אָפּציאָנעלע אידענטיפֿיקאַטאָר וואָס גרופּירט קעסטלעך פֿאַר איין אָביעקט.
seedאָפּציאָנעל
טיפּinteger | null
סיד גענוצט פֿאַר רעפּראָדוצירבאַרער טראַפֿישער גענערירונג.
pointmap_urlאָפּציאָנעל
טיפּstring | null
אָפּציאָנעלער URL צו פֿאַרבעסערן טיפֿקייט־אָפּשאַצונג אין 3D־רעקאָנסטרוקציע דורך צושטעלן אויסערלעכע פּונקט־מאַפּע־ אָדער טיפֿקייט־דאַטן ווי NPY אָדער NPZ.
detection_thresholdאָפּציאָנעל
טיפּnumber | null
0.1 – 1
שוועל פֿאַר דער דערקענונגס־צוטרוי; בײַם אויסלאָזן ווערט גענוצט דער סטאַנדאַרט פֿונעם מאָדעל. די ווערטן גייען פֿון 0.1 ביז 1.0; קלענערע ווערטן פֿאַרגרעסערן די צאָל דערקענונגען אויפֿן חשבון פֿון פּינקטלעכקייט.
export_textured_glbאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
GLB־עקספּאָרט־אָפּציע: דאָס אַקטיווירן פֿאַרבײַט שפּיץ־פֿאַרבן מיט אַן אײַנגעבאַקענער טעקסטור און UVs.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

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

אויסגאַבע

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
אייער טעקעס, אייער ברירהיעדער outputs[].url איז אַ קאַפּיע אין אונדזער סטאָרידזש: געהאַלטן אויף אייביק (באַצאָלט פּער GB־חודש) אָדער 7 טעג אומזיסט, לויט אײַער חשבון־באַשטעטיקונג אָדער ?storage=.
דער זעלבער פֿאָרעם בײַ יעדן מאָדעלtype, url, content_type, width, height און duration, סײַ פֿאַר בילדער, ווידעאָ און אַודיאָ. output איז דער אייגענער רעזולטאַט־אָביעקט פֿון מאָדעל.
פֿעלדער פֿון דער אויסגאַבע
gaussian_splat
object {url, content_type, file_name, file_size}אַ צונויפֿגעשטעלטער סצענע־ספּלאַט פֿאַר רעזולטאַטן מיט עטלעכע אָביעקטן, אַנדערש אַ באַזונדערער ספּלאַט; צוגעשטעלט ווי אַ גאַוסישער ספּלאַט־פֿײַל אין .ply־פֿאָרמאַט.
model_glb
object {url, content_type, file_name, file_size}3D־רעזולטאַט געהיט ווי GLB: עטלעכע אָביעקטן ווערן צונויפֿגעשטעלט אין איין סצענע, בשעת אַנדערע רעזולטאַטן אַנטהאַלטן איין נעץ.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}מעטאַדאַטן פֿאַר יעדן אָביעקט, אַרײַנגערעכנט דרייונג, פֿאַרשיבונג און מאָסשטאַב.
individual_splats
array of object {url, content_type, file_name, file_size} | nullבאַזונדערע גאַוסישע ספּלאַט־פֿײַל פֿאַר יעדן אָביעקט, בנימצא נאָר אין סצענעס מיט עטלעכע אָביעקטן.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullבאַזונדערע GLB־נעץ־פֿײַל פֿאַר יעדן אָביעקט, בנימצא נאָר אין סצענעס מיט עטלעכע אָביעקטן.
artifacts_zip
object {url, content_type, file_name, file_size} | nullZIP־אַרכיוו מיט אַלע געשאַפֿענע פֿײַל און מעטאַדאַטן.

מער מאָדעלן: בילד צו 3D

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