Lompat ke konten

Segment Anything Model 3

Integrasikan

ID model sam-3/image
# 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/image?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"

Permintaan ini: ≈$0,005 5 kredit API Jalankan di halaman ini

Dapatkan kunci API
Meta Pengeditan Gambar #segmentation#mask#real-time

Segmentasi gambar berbasis prompt teks, titik, atau kotak yang mengembalikan gambar mask, dengan skor dan kotak opsional

Meta · Gambar

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

bawaan wheel

Instruksi teks yang memandu segmentasi.

•wajib image_url
Jatuhkan file, atau

URL yang menunjuk ke gambar untuk segmentasi.

Lanjutan text_prompt · output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts

[DEPRECATED] Input lama yang dipertahankan untuk kompatibilitas mundur; gunakan 'prompt' sebagai gantinya.

output_format bawaan png

Format file untuk gambar hasil.

bawaan 3

Batas atas mask yang dikembalikan saat `return_multiple_masks` diaktifkan.

bawaan []

Kumpulan prompt berbasis titik.

bawaan []

Prompt kotak yang object_id-nya menentukan pengelompokan: ID yang sama mengaitkan kotak dengan satu objek, sedangkan ID kosong menunjukkan objek terpisah. Beberapa kotak dapat diberikan, masing-masing menggunakan koordinat (x_min, y_min, x_max, y_max).

POST /run/sam-3/image?wait=20 estimasi harga → $0,005
# 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/image?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"

Jalankan permintaan ini

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang Segment Anything Model 3

Mensegmentasi gambar dengan SAM 3 menggunakan `prompt` teks, `point_prompts`, atau `box_prompts`. Dengan `return_multiple_masks` aktif, model mengembalikan hingga `max_masks` mask (1 hingga 32). Skor keyakinan dan kotak pembatas opsional dapat disertakan. Format output adalah jpeg, png, atau webp.

Parameter

Kirim nama kanonis atau nama asli, bukan keduanya. Nama kanonis

NamaTipe BawaanDiizinkan Deskripsi
image_urlwajib image
Tipeurl · image
URL yang menunjuk ke gambar untuk segmentasi.
promptopsional
Tipestring
Bawaanwheel
Instruksi teks yang memandu segmentasi.
text_promptopsional
Tipestring | null
[DEPRECATED] Input lama yang dipertahankan untuk kompatibilitas mundur; gunakan 'prompt' sebagai gantinya.
point_promptsopsional
Tipeobject[]
Bawaan[]
Kumpulan prompt berbasis titik.
point_prompts[].xopsional
Tipeinteger | null
Posisi prompt pada sumbu X.
point_prompts[].yopsional
Tipeinteger | null
Posisi prompt pada sumbu Y.
point_prompts[].labelopsional
Tipeenum
01
Label foreground/background: 1 menunjukkan foreground; 0 menunjukkan background.
point_prompts[].object_idopsional
Tipeinteger | null
Pengenal opsional yang mengelompokkan prompt untuk menyempurnakan satu objek. Jika teks juga diberikan sebagai prompt, pengenal ini menentukan objek terdeteksi mana yang disempurnakan oleh titik tersebut.
point_prompts[].frame_indexopsional
Tipeinteger | null
Indeks yang mengidentifikasi bingkai untuk interaksi.
box_promptsopsional
Tipeobject[]
Bawaan[]
Prompt kotak yang object_id-nya menentukan pengelompokan: ID yang sama mengaitkan kotak dengan satu objek, sedangkan ID kosong menunjukkan objek terpisah. Beberapa kotak dapat diberikan, masing-masing menggunakan koordinat (x_min, y_min, x_max, y_max).
box_prompts[].x_minopsional
Tipeinteger | null
Koordinat x minimum untuk kotak.
box_prompts[].y_minopsional
Tipeinteger | null
Koordinat y minimum untuk kotak.
box_prompts[].x_maxopsional
Tipeinteger | null
Koordinat X maksimum untuk kotak.
box_prompts[].y_maxopsional
Tipeinteger | null
Koordinat Y maksimum untuk kotak.
box_prompts[].object_idopsional
Tipeinteger | null
Pengenal opsional yang mengelompokkan kotak untuk menyempurnakan satu objek.
box_prompts[].frame_indexopsional
Tipeinteger | null
Indeks yang mengidentifikasi bingkai untuk interaksi.
apply_maskopsional
Tipeboolean
Bawaantrue
Mengontrol apakah gambar diberi mask.
output_formatopsional
Tipeenum
Bawaanpng
jpegpngwebp
Format file untuk gambar hasil.
return_multiple_masksopsional
Tipeboolean
Bawaanfalse
Opsi pengembalian beberapa mask: mengaktifkannya menggunakan `max_masks` untuk menentukan jumlah mask yang dibuat untuk diunggah dan disertakan dalam respons.
max_masksopsional
Tipeinteger
Bawaan3
1 – 32
Batas atas mask yang dikembalikan saat `return_multiple_masks` diaktifkan.
include_scoresopsional
Tipeboolean
Bawaanfalse
Mengontrol penyertaan skor keyakinan untuk mask.
include_boxesopsional
Tipeboolean
Bawaanfalse
Mengontrol penyertaan bounding box untuk setiap mask, jika tersedia.
wajib Nama kanonis, juga diterima

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3/image",
  "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": 5,
    "usd": "0.005",
    "charged": 5,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "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,
      "width": 1024,
      "height": 768
    },
    "masks": [
      {
        "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,
        "width": 1024,
        "height": 768
      }
    ],
    "metadata": [
      {
        "index": 1,
        "score": 1.0,
        "box": [
          1.0
        ]
      }
    ],
    "scores": [
      1.0
    ],
    "boxes": [
      [
        1.0
      ]
    ]
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
image
object {url, content_type, file_name, file_size, width, height} | nullPratinjau yang menampilkan mask segmentasi utama.
masks
array of object {url, content_type, file_name, file_size, width, height}Gambar yang berisi mask segmentasi.
metadata
array of object {index, score, box} | nullMetadata untuk setiap mask, termasuk skor dan kotaknya.
scores
array of number | nullSkor keyakinan untuk setiap mask, diberikan jika diminta.
boxes
array of array of number | nullKotak ternormalisasi untuk setiap mask, dinyatakan sebagai [cx, cy, w, h], jika diminta.

Model lainnya: Pengeditan Gambar

Untuk agen AI: halaman ini dalam Markdown tersedia di https://doitong.com/id/developers/models/sam-3/image.md. Semua model dan panduan: https://doitong.com/developers/llms.txt