İçeriğe geç

Sam 3 1 · Image

Entegre et

Model kimliği 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Bu istek: ≈$0,01 10 API kredisi Bu sayfada çalıştır

API anahtarı al
Meta Görsel Düzenleme #segmentation#mask#real-time

Metin, nokta veya kutu promptlarından SAM 3.1 görsel segmentasyonu; maske görselleri döndürür

Meta · Görsel

İlk sonucunuz burada görünecek

Aşağıda bir istek oluşturun ve API anahtarınızla çalıştırın. Çıktılar depolamamıza kopyalanır ve sonsuza kadar veya ücretsiz olarak 7 gün boyunca saklanır.

İstek oluştur

Kontroller model şemasından oluşturulur. Değerleri değiştirdikçe kod ve fiyat güncellenir.

varsayılan wheel

Segmentasyona rehberlik eden metin talimatı.

•gerekli image_url
Dosyayı bırakın veya

Segmentasyon yapılacak görsele işaret eden URL.

Gelişmiş output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts
output_format varsayılan png

Ortaya çıkan görselin dosya biçimi.

varsayılan 3

`return_multiple_masks` etkin olduğunda döndürülen maskeler için üst sınır.

varsayılan []

Nokta tabanlı istemler koleksiyonu.

varsayılan []

object_id değeri gruplandırmayı belirleyen kutu istemleri: eşleşen kimlikler kutuları bir nesneyle ilişkilendirirken boş kimlikler ayrı nesneleri temsil eder. Her biri (x_min, y_min, x_max, y_max) koordinatlarını kullanan birden çok kutu sağlanabilir.

POST /run/sam-3-1/image?wait=20 fiyat → $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?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"

Bu isteği çalıştır

Anahtarınız bu tarayıcıda kalır: yalnızca Doitong API'ye gönderilir ve yalnızca Hatırla seçeneğini işaretlerseniz localStorage'a kaydedilir. API anahtarı al

Sam 3 1 · Image hakkında

SAM 3.1 kullanarak bir görseli metin `prompt`ı, `point_prompts` veya `box_prompts` ile segmentlere ayırır. Bir nesne için birden fazla kutu object_id ile gruplanabilir. `return_multiple_masks`, isteğe bağlı skorlar ve sınırlayıcı kutularla `max_masks` kadar (1 ila 32) maske döndürür. Çıktı biçimi jpeg, png veya webp'dir.

Parametreler

Kanonik adı veya yerel adı gönderin; ikisini birden göndermeyin. Kanonik adlar

AdTür Varsayılanİzin verilen Açıklama
image_urlgerekli image
Türurl · image
Segmentasyon yapılacak görsele işaret eden URL.
promptisteğe bağlı
Türstring
Varsayılanwheel
Segmentasyona rehberlik eden metin talimatı.
point_promptsisteğe bağlı
Türobject[]
Varsayılan[]
Nokta tabanlı istemler koleksiyonu.
point_prompts[].xisteğe bağlı
Türinteger | null
İstemin X ekseni üzerindeki konumu.
point_prompts[].yisteğe bağlı
Türinteger | null
İstemin Y ekseni üzerindeki konumu.
point_prompts[].labelisteğe bağlı
Türenum
01
Ön plan/arka plan etiketi: 1 ön planı, 0 arka planı belirtir.
point_prompts[].object_idisteğe bağlı
Türinteger | null
Tek bir nesneyi iyileştiren istemleri gruplandıran isteğe bağlı tanımlayıcı. Metin de istem olarak sağlanırsa bu tanımlayıcı, noktaların hangi algılanan nesneyi iyileştireceğini belirler.
point_prompts[].frame_indexisteğe bağlı
Türinteger | null
Etkileşim için kareyi tanımlayan dizin.
box_promptsisteğe bağlı
Türobject[]
Varsayılan[]
object_id değeri gruplandırmayı belirleyen kutu istemleri: eşleşen kimlikler kutuları bir nesneyle ilişkilendirirken boş kimlikler ayrı nesneleri temsil eder. Her biri (x_min, y_min, x_max, y_max) koordinatlarını kullanan birden çok kutu sağlanabilir.
box_prompts[].x_ministeğe bağlı
Türinteger | null
Kutunun minimum x koordinatı.
box_prompts[].y_ministeğe bağlı
Türinteger | null
Kutunun minimum y koordinatı.
box_prompts[].x_maxisteğe bağlı
Türinteger | null
Kutu için maksimum X koordinatı.
box_prompts[].y_maxisteğe bağlı
Türinteger | null
Kutu için maksimum Y koordinatı.
box_prompts[].object_idisteğe bağlı
Türinteger | null
Tek bir nesneyi iyileştiren kutuları gruplandıran isteğe bağlı tanımlayıcı.
box_prompts[].frame_indexisteğe bağlı
Türinteger | null
Etkileşim için kareyi tanımlayan dizin.
apply_maskisteğe bağlı
Türboolean
Varsayılantrue
Görsele maskenin uygulanıp uygulanmayacağını denetler.
output_formatisteğe bağlı
Türenum
Varsayılanpng
jpegpngwebp
Ortaya çıkan görselin dosya biçimi.
return_multiple_masksisteğe bağlı
Türboolean
Varsayılanfalse
Birden çok maske döndürme seçeneği: etkinleştirildiğinde yüklenecek ve yanıta eklenecek oluşturulmuş maske sayısını belirlemek için `max_masks` kullanılır.
max_masksisteğe bağlı
Türinteger
Varsayılan3
1 – 32
`return_multiple_masks` etkin olduğunda döndürülen maskeler için üst sınır.
include_scoresisteğe bağlı
Türboolean
Varsayılanfalse
Maskeler için güven skorlarının eklenmesini denetler.
include_boxesisteğe bağlı
Türboolean
Varsayılanfalse
Varsa her maske için sınırlayıcı kutunun eklenmesini denetler.
gerekli Kanonik ad, bu ad da kabul edilir

Dosya parametreleri herkese açık bir https:// URL'si, 10 MB'a kadar bir data: URI'si veya yüklenen bir dosyanın file_url değerini kabul eder. Dosyalar

Çıktı

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Dosyalarınız, seçiminizHer outputs[].url, depolamamızdaki bir kopyadır: sonsuza kadar (GB-ay başına ücretli) veya ücretsiz olarak 7 gün boyunca, hesap ayarınızla ya da ?storage= ile saklanır.
Her modelde aynı yapıGörüntüler, video ve ses için type, url, content_type, width, height ve duration aynıdır. output, modelin kendi sonuç nesnesidir.
Çıktı alanları
image
object {url, content_type, file_name, file_size, width, height} | nullBirincil segmentasyon maskesini gösteren ön izleme.
masks
array of object {url, content_type, file_name, file_size, width, height}Segmentasyon maskeleri içeren görseller.
metadata
array of object {index, score, box} | nullHer maske için puanını ve kutusunu içeren meta veriler.
scores
array of number | nullİstendiğinde sağlanan her maske için güven puanı.
boxes
array of array of number | nullİstendiğinde [cx, cy, w, h] olarak ifade edilen her maske için normalleştirilmiş kutular.

Daha fazla model: Görsel Düzenleme

AI aracıları için: bu sayfanın Markdown biçimi şurada: https://doitong.com/tr/developers/models/sam-3-1/image.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt