Avançar 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"

Este pedido: ≈0,02 $ 20 créditos da API Executar nesta página

Obter chave de API
Meta · 3D

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

predefinição car

Texto utilizado para segmentação automática quando não existem máscaras, como 'chair' ou 'lamp'.

•obrigatório image_url
Largue um ficheiro ou

URL da imagem para reconstrução 3D.

Avançado mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Largue um ficheiro ou

Lista opcional de URLs de máscaras por objeto. Sem máscaras, a segmentação automática utiliza prompt, point_prompts ou box_prompts, se fornecidos; se não forem fornecidas máscaras nem prompts de segmentação, é utilizada a imagem inteira.

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 deteção, deixado na predefinição do modelo quando omitido. Os valores variam de 0.1 a 1.0; valores menores trocam precisão por um maior número de deteções.

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

predefinição []

Prompts baseados em pontos utilizados para segmentação automática quando não existem máscaras.

predefinição []

Prompts de caixas que produzem máscaras individuais de objetos para reconstrução 3D através de segmentação automática, utilizados apenas quando não são fornecidas máscaras. Podem ser submetidas várias caixas.

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 este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar Lembrar. Obter uma chave de API

Sobre Sam 3 · 3D Objects

Transforma objetos de uma fotografia em recursos 3D. Selecione objetos com `mask_urls`, um `prompt` de texto, `point_prompts` ou `box_prompts`; várias caixas produzem objetos separados. `detection_threshold` aceita valores de 0.1 a 1, e `export_textured_glb` incorpora a textura e os UV. Os resultados incluem um GLB, ficheiros Gaussian splat, ficheiros 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 Predefiniçã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 utiliza prompt, point_prompts ou box_prompts, se fornecidos; se não forem fornecidas máscaras nem prompts de segmentação, é utilizada a imagem inteira.
promptopcional
Tipostring | null
Predefiniçãocar
Texto utilizado para segmentação automática quando não existem máscaras, como 'chair' ou 'lamp'.
point_promptsopcional
Tipoobject[]
Predefinição[]
Prompts baseados em pontos utilizados para segmentação automática quando não existem máscaras.
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
Etiqueta 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 também for fornecido texto como prompt, este identificador determina qual objeto detetado esses pontos refinam.
box_promptsopcional
Tipoobject[]
Predefinição[]
Prompts de caixas que produzem máscaras individuais de objetos para reconstrução 3D através de segmentação automática, utilizados apenas quando não são fornecidas máscaras. Podem ser submetidas várias caixas.
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 deteção, deixado na predefinição do modelo quando omitido. Os valores variam de 0.1 a 1.0; valores menores trocam precisão por um maior número de deteções.
export_textured_glbopcional
Tipoboolean
Predefiniçãofalse
Opção de exportação GLB: ativar esta opção substitui as cores dos vértices por uma textura e UVs incorporados.
obrigatório Nome canónico, também aceite

Os parâmetros de ficheiro aceitam um URL https:// público, um URI data: até 10 MB ou o file_url de um carregamento. Ficheiros

Resultado

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"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
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 ficheiro Gaussian splat no formato .ply.
model_glb
object {url, content_type, file_name, file_size}Saída 3D guardada como GLB: vários objetos são reunidos numa única cena, enquanto os restantes 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} | nullFicheiros Gaussian splat separados para cada objeto, disponíveis apenas em cenas com vários objetos.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullFicheiros de malha GLB separados para cada objeto, disponíveis apenas em cenas com vários objetos.
artifacts_zip
object {url, content_type, file_name, file_size} | nullArquivo ZIP de todos os artefactos e metadados.

Mais modelos: Imagem para 3D

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