Мазмұнға өту

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"

Осы сұрау: ≈0,02 $ 20 API кредиті Осы бетте іске қосу

API кілтін алу
Meta Кескіннен 3D-ге #3d#object

Мәтін, нүкте, жақтау сұраулары немесе маскалар арқылы таңдалған суреттегі нысандарды splat шығысымен 3D форматында қалпына келтіреді

Meta · 3D

Алғашқы нәтижеңіз осында пайда болады

Төменде сұрау құрып, оны API кілтіңізбен іске қосыңыз. Шығыстар сақтау орнымызға көшіріліп, мәңгі немесе 7 күн тегін сақталады.

Сұрау жасау

Басқару элементтері модель схемасынан жасалады. Оларды өзгерткен сайын код пен баға жаңартылады.

әдепкі car

Маскалар болмаған кезде автоматты сегментацияға қолданылатын мәтін, мысалы, 'chair' немесе 'lamp'.

•міндетті image_url
Файлды тастаңыз немесе

3D реконструкцияға арналған кескін URL мекенжайы.

Қосымша mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Файлды тастаңыз немесе

Нысандар бойынша қосымша маска URL мекенжайларының тізімі. Маскалар болмаса, автоматты сегментация берілген нұсқау, point_prompts немесе box_prompts мәндерін пайдаланады; маскалар да, сегментация нұсқаулары да берілмесе, бүкіл кескін қолданылады.

NPY немесе NPZ форматындағы сыртқы pointmap не depth деректерін беру арқылы 3D реконструкциядағы тереңдікті бағалауды жақсартуға арналған қосымша URL.

Көрсетілмесе, модельдің әдепкі мәні қолданылатын анықтау сенімділігінің шегі. Мәндер 0.1–1.0 аралығында; кіші мәндер дәлдікті азайтып, анықтаулар санын арттырады.

Қайталанымды кездейсоқ генерация үшін қолданылатын seed.

әдепкі []

Маскалар болмаған кезде автоматты сегментацияға қолданылатын нүктелік нұсқаулар.

әдепкі []

Автоматты сегментация арқылы 3D реконструкцияға арналған жеке нысан маскаларын беретін box нұсқаулары; маскалар берілмегенде ғана қолданылады. Бірнеше box жіберуге болады.

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"

Осы сұрауды іске қосу

Кілтіңіз осы браузерде қалады: ол тек Doitong API-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

Sam 3 · 3D Objects туралы

Фотосуреттегі нысандарды 3D активтерге айналдырады. Нысандарды `mask_urls`, мәтіндік `prompt`, `point_prompts` немесе `box_prompts` арқылы таңдаңыз; бірнеше жақтау бөлек нысандар береді. `detection_threshold` 0.1–1 мәндерін қабылдайды, ал `export_textured_glb` текстура мен UV-ларды біріктіреді. GLB, Gaussian splat файлдары, көп нысанды сахналарға арналған нысандық файлдар, метадеректер және zip бумасын шығарады.

Параметрлер

Канондық атауды немесе төл атауды жіберіңіз, екеуін қатар жібермеңіз. Канондық атаулар

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
image_urlміндетті image
Түріurl · image
3D реконструкцияға арналған кескін URL мекенжайы.
mask_urlsміндетті емес
Түріurl[] · image
Нысандар бойынша қосымша маска URL мекенжайларының тізімі. Маскалар болмаса, автоматты сегментация берілген нұсқау, 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 нұсқаулары; маскалар берілмегенде ғана қолданылады. Бірнеше box жіберуге болады.
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
Қайталанымды кездейсоқ генерация үшін қолданылатын seed.
pointmap_urlміндетті емес
Түріstring | null
NPY немесе NPZ форматындағы сыртқы pointmap не depth деректерін беру арқылы 3D реконструкциядағы тереңдікті бағалауды жақсартуға арналған қосымша URL.
detection_thresholdміндетті емес
Түріnumber | null
0,1 – 1
Көрсетілмесе, модельдің әдепкі мәні қолданылатын анықтау сенімділігінің шегі. Мәндер 0.1–1.0 аралығында; кіші мәндер дәлдікті азайтып, анықтаулар санын арттырады.
export_textured_glbміндетті емес
Түріboolean
Әдепкіfalse
GLB экспорттау параметрі: қосылғанда vertex colors мәндері baked texture және UV мәндерімен ауыстырылады.
міндетті Канондық атау, бұл да қабылданады

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың 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-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
gaussian_splat
object {url, content_type, file_name, file_size}Бірнеше нысаны бар нәтижелерге арналған біріктірілген scene splat, ал басқа жағдайда бір splat; .ply форматындағы Gaussian splat файлы ретінде беріледі.
model_glb
object {url, content_type, file_name, file_size}GLB ретінде сақталған 3D шығыс: бірнеше нысан бір көрініске біріктіріледі, ал басқа нәтижелерде бір mesh болады.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Айналдыру, жылжыту және масштабты қоса алғандағы әр нысанның метадеректері.
individual_splats
array of object {url, content_type, file_name, file_size} | nullӘр нысанға арналған бөлек Gaussian splat файлдары; тек бірнеше нысаны бар көріністерде қолжетімді.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullӘр нысанға арналған бөлек GLB mesh файлдары; тек бірнеше нысаны бар көріністерде қолжетімді.
artifacts_zip
object {url, content_type, file_name, file_size} | nullБарлық артефактілер мен метадеректері бар ZIP архиві.

Қосымша модельдер: Кескіннен 3D-ге

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/sam-3/3d-objects.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt