Ir al contenido

Moondream3 Preview [Segment]

Integrar

ID del modelo 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"

Esta solicitud: ≈$0.003 3 créditos de API Ejecutar en esta página

Obtener clave de API
Moondream Edición de imágenes Entradas de referencia #mask#segmentation

Segmenta un objeto indicado en una imagen y devuelve una máscara, un cuadro delimitador y una ruta SVG

Moondream · Imagen

Tu primer resultado aparecerá aquí

Crea una solicitud abajo y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, donde se conservan para siempre o 7 días gratis.

Crear una solicitud

Los controles se generan a partir del esquema del modelo. El código y el precio se actualizan conforme los cambias.

•obligatorio image_url
Suelta un archivo o

URL que apunta a la imagen que se procesará.

•obligatorio

Objeto objetivo para la segmentación dentro de la imagen.

Avanzado preview · spatial_references · settings

Guía espacial para la segmentación, proporcionada como una lista de objetos Point cuyos miembros son x y y, o como una lista de arreglos de coordenadas. Cada arreglo debe contener 2 floats (x,y) o 4 floats (x1,y1,x2,y2).

Configuración del modelo de segmentación que controla el muestreo.

POST /run/moondream3-preview/segment?wait=20 cotización → $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"

Ejecutar esta solicitud

Tu clave permanece en este navegador: solo se envía a la Doitong API y se guarda en localStorage únicamente si marcas Recordar. Obtener una clave de API

Acerca de Moondream3 Preview [Segment]

Segmenta el objeto indicado en `object` dentro de la imagen de `image_url`. El resultado puede incluir una imagen de máscara, un cuadro delimitador y datos de ruta SVG; son null si no se detecta nada. `spatial_references` puede proporcionar puntos para guiar la segmentación y `settings` ajusta el muestreo. Establece `preview` para obtener una máscara binaria.

Parámetros

Envía el nombre canónico o el nombre nativo, no ambos. Nombres canónicos

NombreTipo PredeterminadoPermitido Descripción
image_urlobligatorio image
Tipourl · image
URL que apunta a la imagen que se procesará.
objectobligatorio
Tipostring
Objeto objetivo para la segmentación dentro de la imagen.
spatial_referencesopcional
Tipoany[]
Guía espacial para la segmentación, proporcionada como una lista de objetos Point cuyos miembros son x y y, o como una lista de arreglos de coordenadas. Cada arreglo debe contener 2 floats (x,y) o 4 floats (x1,y1,x2,y2).
settingsopcional
Tipoobject
Configuración del modelo de segmentación que controla el muestreo.
settings.temperatureopcional
Tiponumber
Predeterminado1
0 – 1
La temperatura de muestreo establece el equilibrio entre una salida enfocada y determinista con valores bajos y una mayor aleatoriedad con valores altos.
settings.top_popcional
Tiponumber
Predeterminado1
0 – 1
Masa de probabilidad para el muestreo de núcleo, de 0 a 1.
settings.max_tokensopcional
Tipointeger | null
≥ 1
Límite superior de tokens generados.
previewopcional
Tipoboolean
Predeterminadofalse
Indica si se debe devolver la máscara binaria de la imagen junto con una vista previa de salida.
obligatorio Nombre canónico, también aceptado

Los parámetros de archivo aceptan una URL pública https://, un URI data: de hasta 10 MB o el file_url de una carga. Archivos

Salida

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"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: se conserva para siempre (con cobro por GB-mes) o 7 días gratis, según la configuración de tu cuenta o ?storage=.
La misma estructura en todos los modelostype, url, content_type, width, height y duration, tanto para imágenes como para video y audio. output es el objeto de resultado propio del modelo.
Campos de salida
finish_reason
stringMotivo por el que terminó la generación de la salida.
usage_info
object {input_tokens, output_tokens, prefill_time_ms, decode_time_ms, ttft_ms}Detalles del uso de la solicitud.
image
object {url, content_type, file_name, file_size, width, height} | nullResultado de la vista previa de segmentación: null si no se solicitó la generación de vista previa o la detección de objetos no encontró nada; de lo contrario, una imagen que contiene la máscara.
path
string | nullDatos de ruta SVG devueltos cuando se detecta una máscara de segmentación; de lo contrario, null.
bbox
object {x_min, y_min, x_max, y_max} | nullCuadro delimitador devuelto para un objeto detectado y segmentado; de lo contrario, null.

Más modelos: Edición de imágenes

Para agentes de IA: esta página en Markdown está disponible en https://doitong.com/es-MX/developers/models/moondream3-preview/segment.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt