Мазмұнға өту

Sam 3 · 3D Align

Интеграциялау

Модель идентификаторы 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

API кілтін алу
Meta 3D #align#3d

SAM 3D дене торын бастапқы фотосурет көрінісіне сәйкестендіріп, қажет болса оны нысан торымен біріктіреді

Meta · 3D

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

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

Сұрау жасау

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

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

MoGe арқылы тереңдікті бағалауға арналған бастапқы кескін URL мекенжайы.

•міндетті

Туралауға арналған mesh URL мекенжайы; .ply немесе .glb форматындағы SAM-3D Body файлын қабылдайды.

Қосымша body_mask_url · object_mesh_url · focal_length
Файлды тастаңыз немесе

Адам маскасының кескіні URL мекенжайы; көрсетілмесе, бүкіл кескін пайдаланылады.

Біріктірілген көрініс жасауға арналған SAM-3D Object үшін қосымша mesh URL мекенжайы, .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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

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

Адам денесінің торын (.ply немесе .glb) бастапқы фотосуреттің координаттар кеңістігіне орналастырады, бұл ретте `image_url` арқылы тереңдікті бағалайды. Қосымша кірістер: адам маскасы, фокустық қашықтық мәні және біріктірілген сахна файлын беретін нысан торы (.glb). Шығыстарға PLY және GLB форматтарындағы тураланған торлар, туралау метадеректері және қабаттастыру визуализациясы кіреді.

Параметрлер

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

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
image_urlміндетті image
Түріurl · image
MoGe арқылы тереңдікті бағалауға арналған бастапқы кескін URL мекенжайы.
body_mesh_urlміндетті
Түріstring
Туралауға арналған mesh URL мекенжайы; .ply немесе .glb форматындағы SAM-3D Body файлын қабылдайды.
body_mask_urlміндетті емес
Түріurl · image
Адам маскасының кескіні URL мекенжайы; көрсетілмесе, бүкіл кескін пайдаланылады.
object_mesh_urlміндетті емес
Түріstring | null
Біріктірілген көрініс жасауға арналған SAM-3D Object үшін қосымша mesh URL мекенжайы, .glb форматында.
focal_lengthміндетті емес
Түріnumber | null
SAM-3D Body метадеректерінен алынған фокус қашықтығын қайта анықтау; мән берілмесе, MoGe бағалауы қолданылады.
міндетті Канондық атау, бұл да қабылданады

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың 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.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 — модельдің өз нәтижелер нысаны.
Шығыс өрістері
body_mesh_ply
object {url, content_type, file_name, file_size}Тураланған дене mesh-і бар PLY файл.
model_glb
object {url, content_type, file_name, file_size}3D алдын ала қарауға арналған тураланған дене mesh-і бар GLB файл.
visualization
object {url, content_type, file_name, file_size}Тураланған mesh үстіне қабаттастырылған кіріс кескінінің визуализациясы.
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 берілгенде ғана қолжетімді; онда бір көрініске біріктірілген дене және нысан mesh-тері бар.

Қосымша модельдер: 3D

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