Bỏ qua đến nội dung

Workflow Utilities Pick Image By Index

Tích hợp

Id mô hình 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"

Yêu cầu này: ≈0,001 $ 1 tín dụng API Chạy trên trang này

Lấy khóa API
Utility · Hình ảnh

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc image_urls
Thả tệp hoặc

Mảng URL hình ảnh dùng làm nguồn lựa chọn.

•bắt buộc

Chọn hình ảnh theo vị trí, đếm từ 1: yêu cầu 1 cho hình ảnh đầu tiên, 2 cho hình ảnh thứ hai và tiếp tục tương tự.

Nâng cao fallback_index
fallback_index mặc định first-image

Chính sách chọn hình ảnh ngoài phạm vi, mặc định là `first-image`; bị bỏ qua với `index` hợp lệ, còn việc xác thực vẫn thất bại nếu `index` nhỏ hơn 1 hoặc mảng `image_urls` rỗng. Chỉ `index` vượt quá độ dài mảng mới kích hoạt chính sách: `first-image` chọn hình ảnh đầu tiên, còn `last-image` chọn hình ảnh cuối cùng.

POST /run/workflow-utilities/pick-image-by-index?wait=20 báo giá → 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"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về Workflow Utilities Pick Image By Index

Trả về một ảnh từ mảng URL ảnh. `index` bắt đầu từ 1, nên 1 là ảnh đầu tiên. Khi chỉ mục vượt quá độ dài danh sách, `fallback_index` quyết định trả về ảnh đầu tiên hay cuối cùng. Hữu ích khi nối các bước trong workflow.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
image_urlsbắt buộc images
Kiểuurl[] · image
Mảng URL hình ảnh dùng làm nguồn lựa chọn.
indexbắt buộc
Kiểuinteger
Chọn hình ảnh theo vị trí, đếm từ 1: yêu cầu 1 cho hình ảnh đầu tiên, 2 cho hình ảnh thứ hai và tiếp tục tương tự.
fallback_indextùy chọn
Kiểuenum
Mặc địnhfirst-image
first-imagelast-image
Chính sách chọn hình ảnh ngoài phạm vi, mặc định là `first-image`; bị bỏ qua với `index` hợp lệ, còn việc xác thực vẫn thất bại nếu `index` nhỏ hơn 1 hoặc mảng `image_urls` rỗng. Chỉ `index` vượt quá độ dài mảng mới kích hoạt chính sách: `first-image` chọn hình ảnh đầu tiên, còn `last-image` chọn hình ảnh cuối cùng.
bắt buộc Tên chuẩn, cũng được chấp nhận

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

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"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
image
object {url, content_type, file_name, file_size, width, height}Hình ảnh được chọn tại vị trí đã chỉ định.
images
array of object {url, content_type, file_name, file_size, width, height}Đầu ra tương thích cho các nút hạ nguồn cần tham chiếu `images`, như được cung cấp bởi merge và các tiện ích khác. Đầu ra chứa hình ảnh đã chọn trong mảng một phần tử, nên các nút đó không cần thay đổi.

Thêm mô hình: Chỉnh sửa hình ảnh

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/workflow-utilities/pick-image-by-index.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt