Ir al contenido

Workflow Utilities Pick Image By Index

Integrar

ID del modelo workflow-utilities/pick-image-by-index
# 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/workflow-utilities/pick-image-by-index?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ],
    "index": 1
  }'

# 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,001 $ 1 crédito de API Ejecutar en esta página

Obtener clave de API
Utility · Imagen

Tu primer resultado aparecerá aquí

Crea una solicitud a continuación y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, conservadas 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 al modificarlos.

•obligatorio image_urls
Suelta un archivo o

Matriz de URL de imágenes utilizada como fuente de selección.

•obligatorio

Selección de imagen por posición, empezando a contar desde 1: solicita 1 para la primera imagen, 2 para la segunda y continúa del mismo modo.

Avanzado fallback_index
fallback_index predeterminado first-image

Política para selecciones de imágenes fuera de rango, con `first-image` como valor predeterminado; se ignora para un `index` válido, y la validación sigue fallando para un `index` inferior a 1 o una matriz `image_urls` vacía. La política solo se activa cuando el `index` supera la longitud de la matriz: `first-image` elige la imagen inicial, mientras que `last-image` elige la final.

POST /run/workflow-utilities/pick-image-by-index?wait=20 presupuesto → 0,001 $
# 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/workflow-utilities/pick-image-by-index?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ],
    "index": 1
  }'

# 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 solo se guarda en localStorage si marcas Recordar. Obtener una clave de API

Acerca de Workflow Utilities Pick Image By Index

Devuelve una imagen de una matriz de URL de imágenes. `index` empieza en 1, por lo que 1 devuelve la primera imagen. Cuando el índice supera la longitud de la lista, `fallback_index` decide si se devuelve la primera o la última imagen. Es útil para encadenar pasos en un flujo de trabajo.

Parámetros

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

NombreTipo PredeterminadoPermitido Descripción
image_urlsobligatorio images
Tipourl[] · image
Matriz de URL de imágenes utilizada como fuente de selección.
indexobligatorio
Tipointeger
Selección de imagen por posición, empezando a contar desde 1: solicita 1 para la primera imagen, 2 para la segunda y continúa del mismo modo.
fallback_indexopcional
Tipoenum
Predeterminadofirst-image
first-imagelast-image
Política para selecciones de imágenes fuera de rango, con `first-image` como valor predeterminado; se ignora para un `index` válido, y la validación sigue fallando para un `index` inferior a 1 o una matriz `image_urls` vacía. La política solo se activa cuando el `index` supera la longitud de la matriz: `first-image` elige la imagen inicial, mientras que `last-image` elige la final.
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 subida. Archivos

Salida

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "workflow-utilities/pick-image-by-index",
  "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": 1,
    "usd": "0.001",
    "charged": 1,
    "refunded": 0
  },
  "input": {
    "image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ],
    "index": 1
  },
  "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
    },
    "images": [
      {
        "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
      }
    ]
  },
  "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: conservada para siempre (con pago 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 vídeo y audio. output es el objeto de resultado propio del modelo.
Campos de salida
image
object {url, content_type, file_name, file_size, width, height}Imagen seleccionada en la posición especificada.
images
array of object {url, content_type, file_name, file_size, width, height}Salida de compatibilidad para nodos posteriores que esperan una referencia `images`, proporcionada por merge y otras utilidades. Contiene la imagen seleccionada en una matriz de un elemento, por lo que esos nodos no requieren cambios.

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

Para agentes de IA: esta página en Markdown está en https://doitong.com/es-ES/developers/models/workflow-utilities/pick-image-by-index.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt