Pāriet uz saturu

Sam 3 · 3D Objects

Integrēt

Modeļa id 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"

Šis pieprasījums: ≈0,02 $ 20 API kredītu Izpildīt šajā lapā

Iegūt API atslēgu
Meta Attēls uz 3D #3d#object

Rekonstruē 3D objektus no attēla, atlasītus ar teksta, punkta vai lodziņa norādēm vai maskām, ar splat izvadi

Meta · 3D

Šeit būs jūsu pirmais rezultāts

Izveidojiet pieprasījumu tālāk un izpildiet to ar savu API atslēgu. Izvades tiek kopētas mūsu krātuvē un glabātas mūžīgi vai 7 dienas bez maksas.

Izveidot pieprasījumu

Vadīklas tiek ģenerētas no modeļa shēmas. Kods un cena tiek atjaunināti, kad tos maināt.

noklusējums car

Teksts automātiskai segmentēšanai, ja masku nav, piemēram, 'chair' vai 'lamp'.

•obligāts image_url
Nometiet failu vai

Attēla URL 3D rekonstrukcijai.

Papildu mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Nometiet failu vai

Neobligāts masku URL saraksts katram objektam. Ja maskas nav norādītas, automātiskā segmentēšana izmanto uzvedni, point_prompts vai box_prompts, ja tie ir norādīti; ja nav norādītas ne maskas, ne segmentēšanas uzvednes, tiek izmantots viss attēls.

Neobligāts URL dziļuma novērtēšanas uzlabošanai 3D rekonstrukcijā, nodrošinot ārējus pointmap vai dziļuma datus NPY vai NPZ formātā.

Noteikšanas ticamības slieksnis; ja nav norādīts, tiek izmantots modeļa noklusējums. Vērtības ir no 0.1 līdz 1.0; mazākas vērtības samazina precizitāti, bet palielina noteikto objektu skaitu.

Sākumvērtība atkārtojamai nejaušai ģenerēšanai.

noklusējums []

Uz punktiem balstītas uzvednes automātiskai segmentēšanai, ja masku nav.

noklusējums []

Rāmju uzvednes, kas automātiskajā segmentēšanā izveido atsevišķas objektu maskas 3D rekonstrukcijai; tās izmanto tikai tad, ja maskas nav norādītas. Var iesniegt vairākus rāmjus.

POST /run/sam-3/3d-objects?wait=20 cena → 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"

Palaist šo pieprasījumu

Jūsu atslēga paliek šajā pārlūkprogrammā: tā tiek nosūtīta tikai uz Doitong API un saglabāta (localStorage) tikai tad, ja atzīmējat Atcerēties. Iegūt API atslēgu

Par Sam 3 · 3D Objects

Pārvērš fotoattēlā redzamos objektus 3D resursos. Izvēlieties objektus ar `mask_urls`, teksta `prompt`, `point_prompts` vai `box_prompts`; vairāki lodziņi izveido atsevišķus objektus. `detection_threshold` pieņem vērtības no 0.1 līdz 1, bet `export_textured_glb` iekļauj tekstūru un UV koordinātas. Izvade ietver GLB failu, Gaussian splat failus, katra objekta failus vairāku objektu ainām, metadatus un zip pakotni.

Parametri

Nosūti vai nu kanonisko nosaukumu, vai vietējo nosaukumu, bet ne abus. Kan啤niskie nosaukumi

NosaukumsTips NoklusējumsAtļauts Apraksts
image_urlobligāts image
Tipsurl · image
Attēla URL 3D rekonstrukcijai.
mask_urlsneobligāts
Tipsurl[] · image
Neobligāts masku URL saraksts katram objektam. Ja maskas nav norādītas, automātiskā segmentēšana izmanto uzvedni, point_prompts vai box_prompts, ja tie ir norādīti; ja nav norādītas ne maskas, ne segmentēšanas uzvednes, tiek izmantots viss attēls.
promptneobligāts
Tipsstring | null
Noklusējumscar
Teksts automātiskai segmentēšanai, ja masku nav, piemēram, 'chair' vai 'lamp'.
point_promptsneobligāts
Tipsobject[]
Noklusējums[]
Uz punktiem balstītas uzvednes automātiskai segmentēšanai, ja masku nav.
point_prompts[].xneobligāts
Tipsinteger | null
Uzvednes pozīcija gar X asi.
point_prompts[].yneobligāts
Tipsinteger | null
Uzvednes pozīcija gar Y asi.
point_prompts[].labelneobligāts
Tipsenum
01
Priekšplāna/fona etiķete: 1 norāda priekšplānu, 0 — fonu.
point_prompts[].object_idneobligāts
Tipsinteger | null
Neobligāts identifikators, kas grupē vienu objektu precizējošās uzvednes. Ja kā uzvedne tiek norādīts arī teksts, šis identifikators nosaka, kuru atklāto objektu šie punkti precizē.
box_promptsneobligāts
Tipsobject[]
Noklusējums[]
Rāmju uzvednes, kas automātiskajā segmentēšanā izveido atsevišķas objektu maskas 3D rekonstrukcijai; tās izmanto tikai tad, ja maskas nav norādītas. Var iesniegt vairākus rāmjus.
box_prompts[].x_minneobligāts
Tipsinteger | null
Taisnstūra minimālā x koordināta.
box_prompts[].y_minneobligāts
Tipsinteger | null
Taisnstūra minimālā y koordināta.
box_prompts[].x_maxneobligāts
Tipsinteger | null
Kastes maksimālā X koordināta.
box_prompts[].y_maxneobligāts
Tipsinteger | null
Kastes maksimālā Y koordināta.
box_prompts[].object_idneobligāts
Tipsinteger | null
Neobligāts identifikators, kas grupē vienu objektu precizējošās kastes.
seedneobligāts
Tipsinteger | null
Sākumvērtība atkārtojamai nejaušai ģenerēšanai.
pointmap_urlneobligāts
Tipsstring | null
Neobligāts URL dziļuma novērtēšanas uzlabošanai 3D rekonstrukcijā, nodrošinot ārējus pointmap vai dziļuma datus NPY vai NPZ formātā.
detection_thresholdneobligāts
Tipsnumber | null
0,1 – 1
Noteikšanas ticamības slieksnis; ja nav norādīts, tiek izmantots modeļa noklusējums. Vērtības ir no 0.1 līdz 1.0; mazākas vērtības samazina precizitāti, bet palielina noteikto objektu skaitu.
export_textured_glbneobligāts
Tipsboolean
Noklusējumsfalse
GLB eksporta izvēle: iespējojot šo opciju, virsotņu krāsas tiek aizstātas ar ieceptu tekstūru un UV koordinātām.
obligāts Kan啤niskais nosaukums, arī pieņemts

Failu parametriem nepieciešams publisks https:// URL, data: URI līdz 10 MB vai augšupielādes file_url. Faili

Izvade

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"
  }
}
Jūsu faili, jūsu izvēleKatrs outputs[].url ir kopija mūsu krātuvē: tiek glabāta mūžīgi (maksa par GB mēnesī) vai 7 dienas bez maksas — atbilstoši konta iestatījumam vai ?storage=.
Vienāda struktūra katram modelimtype, url, content_type, width, height un duration gan attēliem, gan video un audio. output ir paša modeļa rezultāta objekts.
Izvades lauki
gaussian_splat
object {url, content_type, file_name, file_size}Apvienots ainas splats rezultātiem ar vairākiem objektiem vai viens splats citos gadījumos; tiek nodrošināts kā Gausa splata fails .ply formātā.
model_glb
object {url, content_type, file_name, file_size}3D izvade, kas saglabāta kā GLB: vairāki objekti tiek apvienoti vienā ainā, bet citi rezultāti satur vienu tīklu.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Metadati par katru objektu, tostarp rotācija, translācija un mērogs.
individual_splats
array of object {url, content_type, file_name, file_size} | nullAtsevišķi Gausa splata faili katram objektam; pieejami tikai ainās ar vairākiem objektiem.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullAtsevišķi GLB tīkla faili katram objektam; pieejami tikai ainās ar vairākiem objektiem.
artifacts_zip
object {url, content_type, file_name, file_size} | nullZIP arhīvs ar visiem artefaktiem un metadatiem.

Vairāk modeļu: Attēls uz 3D

AI aģentiem: šī lapa Markdown formātā ir pieejama https://doitong.com/lv/developers/models/sam-3/3d-objects.md. Visi modeļi un ceļveži: https://doitong.com/developers/llms.txt