Langkau ke kandungan

Sam 3 1 · Image

Integrasikan

ID model sam-3-1/image
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/sam-3-1/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Permintaan ini: ≈$0.01 10 kredit API · ≈ ₽1.07 Jalankan pada halaman ini

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

Segmentasi imej SAM 3.1 daripada prompt teks, titik atau kotak, dengan pengembalian imej topeng

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.

lalai wheel

Arahan teks yang membimbing pembahagian.

•diperlukan image_url
Lepaskan fail, atau

URL yang menunjuk kepada imej untuk pembahagian.

Lanjutan output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts
output_format lalai png

Format fail untuk imej yang terhasil.

lalai 3

Had atas topeng yang dipulangkan apabila `return_multiple_masks` didayakan.

lalai []

Koleksi prompt berasaskan titik.

lalai []

Prompt kotak yang object_id-nya menentukan pengumpulan: ID sepadan mengaitkan kotak dengan satu objek, manakala ID kosong mewakili objek berasingan. Berbilang kotak boleh diberikan, setiap satu menggunakan koordinat (x_min, y_min, x_max, y_max).

POST /run/sam-3-1/image?wait=20 sebut harga → $0.01
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/sam-3-1/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.ru/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 Sam 3 1 · Image

Membahagikan satu imej dengan SAM 3.1 menggunakan `prompt` teks, `point_prompts` atau `box_prompts`. Beberapa kotak boleh dikumpulkan mengikut objek dengan object_id. `return_multiple_masks` mengembalikan sehingga `max_masks` topeng (1 hingga 32), dengan skor dan kotak pembatas pilihan. Format output ialah jpeg, png atau webp.

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.
promptpilihan
Jenisstring
Lalaiwheel
Arahan teks yang membimbing pembahagian.
point_promptspilihan
Jenisobject[]
Lalai[]
Koleksi prompt berasaskan titik.
point_prompts[].xpilihan
Jenisinteger | null
Kedudukan prompt sepanjang paksi X.
point_prompts[].ypilihan
Jenisinteger | null
Kedudukan prompt sepanjang paksi Y.
point_prompts[].labelpilihan
Jenisenum
01
Label latar depan/latar belakang: 1 menunjukkan latar depan; 0 menunjukkan latar belakang.
point_prompts[].object_idpilihan
Jenisinteger | null
Pengecam pilihan yang mengumpulkan prompt untuk memperhalus satu objek. Jika teks juga diberikan sebagai prompt, pengecam ini menentukan objek yang dikesan untuk diperhalus oleh titik tersebut.
point_prompts[].frame_indexpilihan
Jenisinteger | null
Indeks yang mengenal pasti bingkai untuk interaksi.
box_promptspilihan
Jenisobject[]
Lalai[]
Prompt kotak yang object_id-nya menentukan pengumpulan: ID sepadan mengaitkan kotak dengan satu objek, manakala ID kosong mewakili objek berasingan. Berbilang kotak boleh diberikan, setiap satu menggunakan koordinat (x_min, y_min, x_max, y_max).
box_prompts[].x_minpilihan
Jenisinteger | null
Koordinat x minimum untuk kotak.
box_prompts[].y_minpilihan
Jenisinteger | null
Koordinat y minimum untuk kotak.
box_prompts[].x_maxpilihan
Jenisinteger | null
Koordinat X maksimum untuk kotak.
box_prompts[].y_maxpilihan
Jenisinteger | null
Koordinat Y maksimum untuk kotak.
box_prompts[].object_idpilihan
Jenisinteger | null
Pengecam pilihan yang mengumpulkan kotak untuk memperhalus satu objek.
box_prompts[].frame_indexpilihan
Jenisinteger | null
Indeks yang mengenal pasti bingkai untuk interaksi.
apply_maskpilihan
Jenisboolean
Lalaitrue
Mengawal sama ada topeng digunakan pada imej.
output_formatpilihan
Jenisenum
Lalaipng
jpegpngwebp
Format fail untuk imej yang terhasil.
return_multiple_maskspilihan
Jenisboolean
Lalaifalse
Pilihan pemulangan berbilang topeng: mendayakannya menggunakan `max_masks` untuk menentukan bilangan topeng yang dijana untuk dimuat naik dan disertakan dalam respons.
max_maskspilihan
Jenisinteger
Lalai3
1 – 32
Had atas topeng yang dipulangkan apabila `return_multiple_masks` didayakan.
include_scorespilihan
Jenisboolean
Lalaifalse
Mengawal penyertaan skor keyakinan untuk topeng.
include_boxespilihan
Jenisboolean
Lalaifalse
Mengawal penyertaan kotak sempadan bagi setiap topeng, jika tersedia.
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": "sam-3-1/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": 10,
    "usd": "0.01",
    "charged": 10,
    "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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} | nullPratonton yang menunjukkan topeng pembahagian utama.
masks
array of object {url, content_type, file_name, file_size, width, height}Imej yang mengandungi topeng pembahagian.
metadata
array of object {index, score, box} | nullMetadata bagi setiap topeng, termasuk skor dan kotaknya.
scores
array of number | nullSkor keyakinan bagi setiap topeng, diberikan apabila diminta.
boxes
array of array of number | nullKotak dinormalkan bagi setiap topeng, dinyatakan sebagai [cx, cy, w, h], jika diminta.

Lebih banyak model: Penyuntingan Imej

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