Ir para o conteúdo

Sam 3 · 3D Objects

Integrar

ID do modelo 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"

Esta solicitação: ≈$ 0,02 20 créditos de API Executar nesta página

Obter chave de API
Meta Imagem para 3D #3d#object

Reconstrói objetos 3D a partir de uma imagem, selecionados por prompts de texto, ponto ou caixa, ou por máscaras, com saída de splats

Meta · 3D

Seu primeiro resultado aparecerá aqui

Monte uma requisição abaixo e execute-a com sua chave de API. As saídas são copiadas para nosso armazenamento, mantidas para sempre ou por 7 dias gratuitamente.

Criar uma solicitação

Os controles são gerados a partir do esquema do modelo. O código e o preço são atualizados conforme você os altera.

padrão car

Texto usado para segmentação automática quando as máscaras estão ausentes, como 'chair' ou 'lamp'.

•obrigatório image_url
Solte um arquivo ou

URL da imagem para reconstrução 3D.

Avançado mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Solte um arquivo ou

Lista opcional de URLs de máscaras por objeto. Sem máscaras, a segmentação automática usa prompt, point_prompts ou box_prompts, se fornecidos; se nem máscaras nem prompts de segmentação forem fornecidos, a imagem inteira será usada.

URL opcional para melhorar a estimativa de profundidade na reconstrução 3D, fornecendo dados externos de pointmap ou profundidade como NPY ou NPZ.

Limite de confiança da detecção, deixado no padrão do modelo quando omitido. Os valores variam de 0.1 a 1.0; valores menores trocam precisão por uma quantidade maior de detecções.

Seed usado para geração aleatória reproduzível.

padrão []

Prompts baseados em pontos usados para segmentação automática quando as máscaras estão ausentes.

padrão []

Prompts de caixa que produzem máscaras individuais de objetos para reconstrução 3D por meio da segmentação automática, usados somente quando não há máscaras fornecidas. Várias caixas podem ser enviadas.

POST /run/sam-3/3d-objects?wait=20 cotação → $ 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"

Executar esta solicitação

Sua chave permanece neste navegador: ela é enviada somente à Doitong API e salva (localStorage) apenas se você marcar Lembrar. Obter uma chave de API

Sobre Sam 3 · 3D Objects

Transforma objetos de uma foto em recursos 3D. Escolha objetos com `mask_urls`, um `prompt` de texto, `point_prompts` ou `box_prompts`; várias caixas geram objetos separados. `detection_threshold` aceita valores de 0.1 a 1, e `export_textured_glb` incorpora textura e UVs. As saídas incluem um GLB, arquivos de splats gaussianos, arquivos por objeto para cenas com vários objetos, metadados e um pacote zip.

Parâmetros

Envie o nome canônico ou o nome nativo, não ambos. Nomes canônicos

NomeTipo PadrãoPermitido Descrição
image_urlobrigatório image
Tipourl · image
URL da imagem para reconstrução 3D.
mask_urlsopcional
Tipourl[] · image
Lista opcional de URLs de máscaras por objeto. Sem máscaras, a segmentação automática usa prompt, point_prompts ou box_prompts, se fornecidos; se nem máscaras nem prompts de segmentação forem fornecidos, a imagem inteira será usada.
promptopcional
Tipostring | null
Padrãocar
Texto usado para segmentação automática quando as máscaras estão ausentes, como 'chair' ou 'lamp'.
point_promptsopcional
Tipoobject[]
Padrão[]
Prompts baseados em pontos usados para segmentação automática quando as máscaras estão ausentes.
point_prompts[].xopcional
Tipointeger | null
Posição do prompt no eixo X.
point_prompts[].yopcional
Tipointeger | null
Posição do prompt no eixo Y.
point_prompts[].labelopcional
Tipoenum
01
Rótulo de primeiro plano/fundo: 1 indica primeiro plano; 0 indica fundo.
point_prompts[].object_idopcional
Tipointeger | null
Identificador opcional que agrupa prompts que refinam um único objeto. Se o texto também for fornecido como prompt, esse identificador determina qual objeto detectado esses pontos refinam.
box_promptsopcional
Tipoobject[]
Padrão[]
Prompts de caixa que produzem máscaras individuais de objetos para reconstrução 3D por meio da segmentação automática, usados somente quando não há máscaras fornecidas. Várias caixas podem ser enviadas.
box_prompts[].x_minopcional
Tipointeger | null
Coordenada x mínima da caixa.
box_prompts[].y_minopcional
Tipointeger | null
Coordenada y mínima da caixa.
box_prompts[].x_maxopcional
Tipointeger | null
Coordenada X máxima da caixa.
box_prompts[].y_maxopcional
Tipointeger | null
Coordenada Y máxima da caixa.
box_prompts[].object_idopcional
Tipointeger | null
Identificador opcional que agrupa caixas que refinam um único objeto.
seedopcional
Tipointeger | null
Seed usado para geração aleatória reproduzível.
pointmap_urlopcional
Tipostring | null
URL opcional para melhorar a estimativa de profundidade na reconstrução 3D, fornecendo dados externos de pointmap ou profundidade como NPY ou NPZ.
detection_thresholdopcional
Tiponumber | null
0,1 – 1
Limite de confiança da detecção, deixado no padrão do modelo quando omitido. Os valores variam de 0.1 a 1.0; valores menores trocam precisão por uma quantidade maior de detecções.
export_textured_glbopcional
Tipoboolean
Padrãofalse
Opção de exportação GLB: ativar esta opção substitui as cores dos vértices por uma textura incorporada e UVs.
obrigatório Nome canônico, também aceito

Os parâmetros de arquivo aceitam uma URL https:// pública, um URI data: de até 10 MB ou o file_url de um upload. Arquivos

Saída

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"
  }
}
Seus arquivos, sua escolhaCada outputs[].url é uma cópia em nosso armazenamento: mantida para sempre (cobrada por GB-mês) ou por 7 dias gratuitamente, conforme a configuração da sua conta ou ?storage=.
Mesmo formato em todos os modelostype, url, content_type, width, height e duration, para imagens, vídeos e áudios. output é o próprio objeto de resultado do modelo.
Campos da saída
gaussian_splat
object {url, content_type, file_name, file_size}Splat de cena combinado para resultados com vários objetos, ou um único splat caso contrário; fornecido como arquivo Gaussian splat no formato .ply.
model_glb
object {url, content_type, file_name, file_size}Saída 3D salva como GLB: vários objetos são montados em uma única cena, enquanto os demais resultados contêm uma malha.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Metadados de cada objeto, incluindo rotação, translação e escala.
individual_splats
array of object {url, content_type, file_name, file_size} | nullArquivos Gaussian splat separados para cada objeto, disponíveis somente em cenas com vários objetos.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullArquivos de malha GLB separados para cada objeto, disponíveis somente em cenas com vários objetos.
artifacts_zip
object {url, content_type, file_name, file_size} | nullArquivo ZIP com todos os artefatos e metadados.

Mais modelos: Imagem para 3D

Para agentes de IA: esta página em Markdown está em https://doitong.com/pt-BR/developers/models/sam-3/3d-objects.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt