Sam 3 · 3D Objects
אינטעגרירן
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"
const API = "https://api.doitong.com/v1";
const headers = {
"Authorization": "Bearer " + process.env.DOITONG_API_KEY,
"Content-Type": "application/json",
};
// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/sam-3/3d-objects?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);
// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
import os
import requests
API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}
payload = {
"image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/sam-3/3d-objects", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])
# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/yi/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
--header "Authorization: Bearer $DOITONG_API_KEY"
# 2. Your agent calls the "run" tool with:
{
"model_id": "sam-3/3d-objects",
"input": {
"image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}
}
רופֿט דעם Sam 3 · 3D Objects מאָדעל (sam-3/3d-objects) דורך דער Doitong API. דאָקומענטאַציע פֿאַר אַגענטס: https://doitong.com/yi/developers/models/sam-3/3d-objects.md
POST https://api.doitong.com/v1/run/sam-3/3d-objects?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json
{
"image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}
אויב דער ענטפֿער־סטאַטוס איז "queued" אָדער "running", פֿרעגט מיט GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 ביז ער איז "succeeded"; די פֿײַלן זענען אין outputs[].url. POST https://api.doitong.com/v1/quote/sam-3/3d-objects מיט דעם זעלבן גוף גיט צוריק די גענויע פּרײַז איידערן לויפֿן.
דער דאָזיקער ריקוועסט: ≈$ 0.02 20 API־קרעדיטן לויפֿן עס אויף דער דאָזיקער בלאַט
אײַער נײַער API שליסל. עס ווערט געוויזן בלויז איצט און איז שוין אין דעם קאָד און אין דעם API שליסל־פעלד אונטן. האַלט עס געהיים: לייג עס קיינמאָל נישט אַרײַן אין קאָד וואָס לויפֿט אין אַ בלעטערער.
דאָ קומט אײַער ערשטער רעזולטאַט
בויט אונטן אַ בקשה און לויפט זי מיט אײַער API שליסל. רעזולטאַטן ווערן קאַפּירט צו אונדזער סטאָרידזש, געהאַלטן אויף אייביק אָדער 7 טעג אומזיסט.
בויען אַ בעטן
קאָנטראָלן ווערן דזשענערירט פֿון דעם מאָדעל־סכעמע. דער קאָד און דער פּרײַז דערהײַנטיקן זיך ווען איר ענדערט זיי.
/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"
const API = "https://api.doitong.com/v1";
const headers = {
"Authorization": "Bearer " + process.env.DOITONG_API_KEY,
"Content-Type": "application/json",
};
// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/sam-3/3d-objects?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);
// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
import os
import requests
API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}
payload = {
"image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/sam-3/3d-objects", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])
# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "run",
"arguments": {
"model_id": "sam-3/3d-objects",
"input": {
"image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
},
"wait_seconds": 20
}
}
}
לויפֿן דעם ריקוועסט
אײַער 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
mask_urlsאָפּציאָנעל
promptאָפּציאָנעל
point_promptsאָפּציאָנעל
point_prompts[].xאָפּציאָנעל
point_prompts[].yאָפּציאָנעל
point_prompts[].labelאָפּציאָנעל
point_prompts[].object_idאָפּציאָנעל
box_promptsאָפּציאָנעל
box_prompts[].x_minאָפּציאָנעל
box_prompts[].y_minאָפּציאָנעל
box_prompts[].x_maxאָפּציאָנעל
box_prompts[].y_maxאָפּציאָנעל
box_prompts[].object_idאָפּציאָנעל
seedאָפּציאָנעל
pointmap_urlאָפּציאָנעל
detection_thresholdאָפּציאָנעל
export_textured_glbאָפּציאָנעל
טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 10 MB, אָדער דעם file_url פֿון אַן אַרויפֿלאָד. טעקעס
אויסגאַבע
{
"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"
}
}
פֿעלדער פֿון דער אויסגאַבע
- 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־אַרכיוו מיט אַלע געשאַפֿענע פֿײַל און מעטאַדאַטן.
אַנדערע Sam3 וואַריאַנטן
מער מאָדעלן: בילד צו 3D
פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/sam-3/3d-objects.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt