Lompat ke konten

Segment Anything Model 2 · Image

Integrasikan

ID model sam2/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/sam2/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,002 2 kredit API Jalankan di halaman ini

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

Mensegmentasi objek dalam satu gambar dari prompt titik atau kotak, lalu mengembalikan mask atau gambar bermask

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.

•wajib image_url
Jatuhkan file, atau

URL yang menunjuk ke gambar untuk segmentasi.

Lanjutan output_format · apply_mask · prompts · box_prompts
output_format bawaan png

Format file untuk gambar hasil.

bawaan []

Prompt yang digunakan untuk segmentasi gambar.

bawaan []

Koordinat batas kotak.

POST /run/sam2/image?wait=20 estimasi harga → $0,002
# 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/sam2/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 2 · Image

Mensegmentasikan gambar dengan SAM 2 menggunakan prompt titik (`prompts`) atau koordinat kotak (`box_prompts`). Tetapkan `apply_mask` ke true untuk mendapatkan mask yang diterapkan pada gambar, bukan hanya mask-nya. Output dapat disimpan sebagai jpeg, png, atau webp, dengan png sebagai bawaan. Menerima satu URL gambar per permintaan.

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.
promptsopsional
Tipeobject[]
Bawaan[]
Prompt yang digunakan untuk segmentasi gambar.
prompts[].xopsional
Tipeinteger
Bawaan305
Posisi prompt pada sumbu X.
prompts[].yopsional
Tipeinteger
Bawaan350
Posisi prompt pada sumbu Y.
prompts[].labelopsional
Tipeenum
Bawaan1
01
Label prompt: 1 menunjukkan latar depan, sedangkan 0 menunjukkan latar belakang.
prompts[].frame_indexopsional
Tipeinteger
Bawaan0
Indeks yang mengidentifikasi bingkai untuk interaksi.
box_promptsopsional
Tipeobject[]
Bawaan[]
Koordinat batas kotak.
box_prompts[].x_minopsional
Tipeinteger
Bawaan0
Koordinat x minimum untuk kotak.
box_prompts[].y_minopsional
Tipeinteger
Bawaan0
Koordinat y minimum untuk kotak.
box_prompts[].x_maxopsional
Tipeinteger
Bawaan0
Koordinat x maksimum untuk prompt.
box_prompts[].y_maxopsional
Tipeinteger
Bawaan0
Koordinat y maksimum untuk prompt.
box_prompts[].frame_indexopsional
Tipeinteger
Bawaan0
Indeks yang mengidentifikasi bingkai untuk interaksi.
apply_maskopsional
Tipeboolean
Bawaanfalse
Mengontrol apakah gambar diberi mask.
output_formatopsional
Tipeenum
Bawaanpng
jpegpngwebp
Format file untuk gambar hasil.
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": "sam2/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": 2,
    "usd": "0.002",
    "charged": 2,
    "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
    }
  },
  "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}Gambar dengan segmentasi yang diterapkan.

Model lainnya: Pengeditan Gambar

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