تخطّي إلى المحتوى

Moondream3 Preview [Segment]

التكامل

معرّف النموذج moondream3-preview/segment
# 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/moondream3-preview/segment?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",
    "object": "fox"
  }'

# 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"

هذا الطلب: ≈⁨‏0.003 $⁩ 3 أرصدة API · ≈ ⁨‏0.32 ₽⁩ تشغيله في هذه الصفحة

الحصول على مفتاح API
Moondream تحرير الصور مدخلات مرجعية #mask#segmentation

تجزئة كائن مسمى في صورة وإرجاع قناع ومربع محيط ومسار SVG

Moondream · صورة

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب image_url
أفلت ملفًا، أو

عنوان URL يشير إلى الصورة المطلوب معالجتها.

•مطلوب

العنصر المستهدف للتقسيم داخل الصورة.

متقدم preview · spatial_references · settings

إرشاد مكاني للتقسيم، يُقدّم كقائمة من كائنات Point التي تحتوي أعضاؤها على x وy، أو كقائمة من مصفوفات الإحداثيات. يجب أن تحتوي كل مصفوفة على قيمتي float (x,y) أو 4 قيم float (x1,y1,x2,y2).

إعدادات نموذج التقسيم التي تتحكم في أخذ العينات.

POST /run/moondream3-preview/segment?wait=20 عرض السعر → ⁨‏0.003 $⁩
# 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/moondream3-preview/segment?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",
    "object": "fox"
  }'

# 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"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Moondream3 Preview [Segment]

يُجزّئ الكائن المحدد في `object` داخل الصورة الموجودة في `image_url`. يمكن أن تتضمن النتيجة صورة قناع ومربعًا محيطًا وبيانات مسار SVG؛ وتكون هذه القيم null إذا لم يُكتشف شيء. يمكن لـ`spatial_references` توفير نقاط لتوجيه التجزئة، بينما تضبط `settings` أخذ العينات. اضبط `preview` للحصول على قناع ثنائي.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
عنوان URL يشير إلى الصورة المطلوب معالجتها.
objectمطلوب
النوعstring
العنصر المستهدف للتقسيم داخل الصورة.
spatial_referencesاختياري
النوعany[]
إرشاد مكاني للتقسيم، يُقدّم كقائمة من كائنات Point التي تحتوي أعضاؤها على x وy، أو كقائمة من مصفوفات الإحداثيات. يجب أن تحتوي كل مصفوفة على قيمتي float (x,y) أو 4 قيم float (x1,y1,x2,y2).
settingsاختياري
النوعobject
إعدادات نموذج التقسيم التي تتحكم في أخذ العينات.
settings.temperatureاختياري
النوعnumber
الافتراضي1
0 – 1
تحدد درجة حرارة أخذ العينات التوازن بين المخرج المركز والحتمي عند الإعدادات المنخفضة والعشوائية الأكبر عند الإعدادات العالية.
settings.top_pاختياري
النوعnumber
الافتراضي1
0 – 1
كتلة الاحتمالات لأخذ عينات النواة، وتتراوح من 0 إلى 1.
settings.max_tokensاختياري
النوعinteger | null
≥ 1
الحد الأعلى للرموز المُولّدة.
previewاختياري
النوعboolean
الافتراضيfalse
ما إذا كان سيتم إرجاع القناع الثنائي للصورة مع معاينة المخرج.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "moondream3-preview/segment",
  "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": 3,
    "usd": "0.003",
    "charged": 3,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "object": "fox"
  },
  "output": {
    "finish_reason": "stop",
    "usage_info": {
      "input_tokens": 1,
      "output_tokens": 1,
      "prefill_time_ms": 1.0,
      "decode_time_ms": 1.0,
      "ttft_ms": 1.0
    },
    "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
    },
    "path": "M.657,.996C.610,.984,.529,.938,.447,.875C.411,.848,.363,.815,.341,.802C.188,.714,.093,.623,.038,.511C.011,.455,.000,.406,.000,.340C.000,.269,.006,.234,.025,.186C.051,.123,.092,.079,.161,.042C.240,-0.000,.355,-0.011,.433,.017C.462,.027,.535,.066,.571,.091C.701,.180,.807,.265,.850,.311C.911,.379,.962,.468,.984,.545C.995,.585,.997,.601,.997,.664C.997,.765,.984,.811,.935,.879C.878,.958,.796,1.001,.705,1.000C.685,.999,.664,.998,.657,.996z",
    "bbox": {
      "x_min": 1.0,
      "y_min": 1.0,
      "x_max": 1.0,
      "y_max": 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"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
finish_reason
stringسبب انتهاء توليد المخرج.
usage_info
object {input_tokens, output_tokens, prefill_time_ms, decode_time_ms, ttft_ms}تفاصيل استخدام الطلب.
image
object {url, content_type, file_name, file_size, width, height} | nullنتيجة معاينة التقسيم: null إذا لم يُطلب توليد المعاينة أو لم يكشف اكتشاف العناصر شيئًا؛ وإلا فهي صورة تحتوي على القناع.
path
string | nullبيانات مسار SVG المُعادة عند اكتشاف قناع تقسيم؛ وإلا فهي null.
bbox
object {x_min, y_min, x_max, y_max} | nullالمربع المحيط المُعاد لعنصر مكتشف ومقسّم؛ وإلا فهو null.

مزيد من النماذج: تحرير الصور

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/moondream3-preview/segment.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt