Langkau ke kandungan

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 pada halaman ini

Dapatkan kunci API
Meta Penyuntingan Imej #segmentation#mask#real-time

Mensegmen objek dalam satu imej daripada gesaan titik atau kotak, lalu mengembalikan topeng atau imej bertopeng

Meta · Imej

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan image_url
Lepaskan fail, atau

URL yang menunjuk kepada imej untuk pembahagian.

Lanjutan output_format · apply_mask · prompts · box_prompts
output_format lalai png

Format fail untuk imej yang terhasil.

lalai []

Prompt yang digunakan untuk pembahagian imej.

lalai []

Koordinat sempadan kotak.

POST /run/sam2/image?wait=20 sebut 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

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Segment Anything Model 2 · Image

Mensegmen imej dengan SAM 2 menggunakan gesaan titik (`prompts`) atau koordinat kotak (`box_prompts`). Tetapkan `apply_mask` kepada true untuk mendapatkan topeng yang digunakan pada gambar, bukan topeng sahaja. Output boleh disimpan sebagai jpeg, png atau webp, dengan png sebagai lalai. Menerima satu URL imej bagi setiap permintaan.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
image_urldiperlukan image
Jenisurl · image
URL yang menunjuk kepada imej untuk pembahagian.
promptspilihan
Jenisobject[]
Lalai[]
Prompt yang digunakan untuk pembahagian imej.
prompts[].xpilihan
Jenisinteger
Lalai305
Kedudukan prompt sepanjang paksi X.
prompts[].ypilihan
Jenisinteger
Lalai350
Kedudukan prompt sepanjang paksi Y.
prompts[].labelpilihan
Jenisenum
Lalai1
01
Label prompt: 1 menunjukkan latar depan, manakala 0 menunjukkan latar belakang.
prompts[].frame_indexpilihan
Jenisinteger
Lalai0
Indeks yang mengenal pasti bingkai untuk interaksi.
box_promptspilihan
Jenisobject[]
Lalai[]
Koordinat sempadan kotak.
box_prompts[].x_minpilihan
Jenisinteger
Lalai0
Koordinat x minimum untuk kotak.
box_prompts[].y_minpilihan
Jenisinteger
Lalai0
Koordinat y minimum untuk kotak.
box_prompts[].x_maxpilihan
Jenisinteger
Lalai0
Koordinat x maksimum untuk prompt.
box_prompts[].y_maxpilihan
Jenisinteger
Lalai0
Koordinat y maksimum untuk prompt.
box_prompts[].frame_indexpilihan
Jenisinteger
Lalai0
Indeks yang mengenal pasti bingkai untuk interaksi.
apply_maskpilihan
Jenisboolean
Lalaifalse
Mengawal sama ada topeng digunakan pada imej.
output_formatpilihan
Jenisenum
Lalaipng
jpegpngwebp
Format fail untuk imej yang terhasil.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
image
object {url, content_type, file_name, file_size, width, height}Imej dengan pembahagian diterapkan.

Lebih banyak model: Penyuntingan Imej

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