Lompat ke konten

Workflow Utilities Pick Image By Index

Integrasikan

ID model 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"

Permintaan ini: ≈$0,001 1 kredit API Jalankan di halaman ini

Dapatkan kunci API
Utility · Gambar

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

•wajib image_urls
Jatuhkan file, atau

Array URL gambar yang digunakan sebagai sumber pemilihan.

•wajib

Pemilihan gambar berdasarkan posisi, dihitung mulai dari 1: minta 1 untuk gambar pertama, 2 untuk gambar kedua, dan seterusnya.

Lanjutan fallback_index
fallback_index bawaan first-image

Kebijakan pemilihan gambar di luar rentang, dengan bawaan `first-image`; diabaikan untuk `index` yang valid, dan validasi tetap gagal untuk `index` di bawah 1 atau array `image_urls` kosong. Hanya `index` yang melebihi panjang array yang mengaktifkan kebijakan ini: `first-image` memilih gambar pertama, sedangkan `last-image` memilih gambar terakhir.

POST /run/workflow-utilities/pick-image-by-index?wait=20 estimasi harga → $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"

Jalankan permintaan ini

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang Workflow Utilities Pick Image By Index

Mengembalikan satu gambar dari array URL gambar. `index` berbasis 1, jadi 1 menghasilkan gambar pertama. Jika indeks melebihi panjang daftar, `fallback_index` menentukan apakah gambar pertama atau terakhir yang dikembalikan. Berguna untuk merangkai langkah dalam workflow.

Parameter

Kirim nama kanonis atau nama asli, bukan keduanya. Nama kanonis

NamaTipe BawaanDiizinkan Deskripsi
image_urlswajib images
Tipeurl[] · image
Array URL gambar yang digunakan sebagai sumber pemilihan.
indexwajib
Tipeinteger
Pemilihan gambar berdasarkan posisi, dihitung mulai dari 1: minta 1 untuk gambar pertama, 2 untuk gambar kedua, dan seterusnya.
fallback_indexopsional
Tipeenum
Bawaanfirst-image
first-imagelast-image
Kebijakan pemilihan gambar di luar rentang, dengan bawaan `first-image`; diabaikan untuk `index` yang valid, dan validasi tetap gagal untuk `index` di bawah 1 atau array `image_urls` kosong. Hanya `index` yang melebihi panjang array yang mengaktifkan kebijakan ini: `first-image` memilih gambar pertama, sedangkan `last-image` memilih gambar terakhir.
wajib Nama kanonis, juga diterima

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

Output

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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
image
object {url, content_type, file_name, file_size, width, height}Gambar yang dipilih pada posisi yang ditentukan.
images
array of object {url, content_type, file_name, file_size, width, height}Output kompatibilitas untuk node hilir yang mengharapkan referensi `images`, seperti yang diberikan oleh merge dan utilitas lainnya. Nilai ini berisi gambar terpilih dalam array satu elemen, sehingga node tersebut tidak memerlukan perubahan.

Model lainnya: Pengeditan Gambar

Untuk agen AI: halaman ini dalam Markdown tersedia di https://doitong.com/id/developers/models/workflow-utilities/pick-image-by-index.md. Semua model dan panduan: https://doitong.com/developers/llms.txt