Passer au contenu

Moondream3 Preview [Segment]

Intégrer

Identifiant du modèle 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Cette requête: ≈0,003 $ 3 crédits API L’exécuter sur cette page

Obtenir une clé API
Moondream Édition d’image Entrées de référence #mask#segmentation

Segmente un objet nommé dans une image et renvoie un masque, un cadre englobant et un chemin SVG

Moondream · image

Votre premier résultat apparaîtra ici

Construisez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour lorsque vous les modifiez.

•requis image_url
Déposez un fichier, ou

URL pointant vers l'image à traiter.

•requis

Objet cible pour la segmentation dans l’image.

Avancé preview · spatial_references · settings

Indications spatiales pour la segmentation, fournies sous forme de liste d’objets Point dont les membres sont x et y, ou de liste de tableaux de coordonnées. Chaque tableau doit contenir soit 2 flottants (x,y), soit 4 flottants (x1,y1,x2,y2).

Paramètres du modèle de segmentation contrôlant l’échantillonnage.

POST /run/moondream3-preview/segment?wait=20 devis → 0,003 $
# 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/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement à la Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Moondream3 Preview [Segment]

Segmente l’objet indiqué dans `object` au sein de l’image située dans `image_url`. Le résultat peut inclure une image de masque, un cadre englobant et des données de chemin SVG ; ces valeurs sont null si rien n’est détecté. `spatial_references` peut fournir des points pour guider la segmentation et `settings` règle l’échantillonnage. Définissez `preview` pour obtenir un masque binaire.

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
image_urlrequis image
Typeurl · image
URL pointant vers l'image à traiter.
objectrequis
Typestring
Objet cible pour la segmentation dans l’image.
spatial_referencesfacultatif
Typeany[]
Indications spatiales pour la segmentation, fournies sous forme de liste d’objets Point dont les membres sont x et y, ou de liste de tableaux de coordonnées. Chaque tableau doit contenir soit 2 flottants (x,y), soit 4 flottants (x1,y1,x2,y2).
settingsfacultatif
Typeobject
Paramètres du modèle de segmentation contrôlant l’échantillonnage.
settings.temperaturefacultatif
Typenumber
Par défaut1
0 – 1
La température d’échantillonnage définit l’équilibre entre une sortie ciblée et déterministe avec des réglages faibles et une plus grande part d’aléatoire avec des réglages élevés.
settings.top_pfacultatif
Typenumber
Par défaut1
0 – 1
Masse de probabilité pour l’échantillonnage nucleus, comprise entre 0 et 1.
settings.max_tokensfacultatif
Typeinteger | null
≥ 1
Limite supérieure du nombre de jetons générés.
previewfacultatif
Typeboolean
Par défautfalse
Indique s’il faut renvoyer le masque binaire de l’image avec un aperçu de sortie.
requis Nom canonique, également accepté

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu’à 10 MB ou le file_url d’un téléversement. Fichiers

Sortie

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation au Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, vidéos et fichiers audio. output est le propre objet de résultat du modèle.
Champs de sortie
finish_reason
stringRaison de l’arrêt de la génération de la sortie.
usage_info
object {input_tokens, output_tokens, prefill_time_ms, decode_time_ms, ttft_ms}Détails de l’utilisation de la requête.
image
object {url, content_type, file_name, file_size, width, height} | nullRésultat de l’aperçu de segmentation : null si la génération de l’aperçu n’a pas été demandée ou si la détection d’objet n’a rien trouvé ; sinon, une image contenant le masque.
path
string | nullDonnées de chemin SVG renvoyées lorsqu’un masque de segmentation est détecté ; sinon, null.
bbox
object {x_min, y_min, x_max, y_max} | nullBoîte englobante renvoyée pour un objet détecté et segmenté ; sinon, null.

Plus de modèles : Édition d’image

Pour les agents IA : cette page au format Markdown est disponible à https://doitong.com/fr/developers/models/moondream3-preview/segment.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt