Lompat ke konten

Sam 3 1 · Image RLE

Integrasikan

ID model sam-3-1/image-rle
# 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-1/image-rle?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,01 10 kredit API Jalankan di halaman ini

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

Segmentasi gambar SAM 3.1 yang mengirimkan mask sebagai run-length encoding

Meta · Data (JSON)

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 output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts
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-1/image-rle?wait=20 estimasi 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.com/v1/run/sam-3-1/image-rle?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 Sam 3 1 · Image RLE

Menjalankan segmentasi SAM 3.1 pada gambar dari `prompt` teks, titik, atau kotak, lalu mengembalikan mask sebagai data RLE, bukan file gambar. Mendukung beberapa mask (`max_masks` 1 hingga 32), skor keyakinan, dan kotak pembatas sesuai 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.
promptopsional
Tipestring
Bawaanwheel
Instruksi teks yang memandu segmentasi.
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-1/image-rle",
  "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": {
    "rle": "string",
    "boundingbox_frames_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
    },
    "metadata": [
      {
        "index": 1,
        "score": 1.0,
        "box": [
          1.0
        ]
      }
    ],
    "scores": [
      1.0
    ],
    "boxes": [
      [
        1.0
      ]
    ]
  },
  "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"
  }
}
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
rle
string | array of stringMask yang direpresentasikan menggunakan run-length encoding.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullArsip ZIP overlay kotak pembatas untuk setiap bingkai.
metadata
array of object {index, score, box} | nullMetadata untuk setiap mask, disertakan saat respons berisi beberapa RLE.
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-1/image-rle.md. Semua model dan panduan: https://doitong.com/developers/llms.txt