Bỏ qua đến nội dung

Smart Resize

Tích hợp

Id mô hình smart-resize
# 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/smart-resize?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",
    "target_sizes": [
      "1024x1024",
      "1920x1080",
      "768x1344"
    ]
  }'

# 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"

Các tệp như ví dụ: 0,50 $ 500 tín dụng API tệp của bạn được đo trước khi chạy Chạy trên trang này

Lấy khóa API
Utility Chỉnh sửa hình ảnh Đầu ra 4Ktối đa 4K #realism#typography#visual#ads

Tái bố cục ảnh theo tối đa 10 kích thước đích, hữu ích cho các biến thể quảng cáo và cắt ảnh

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.

0 / 5000

Hướng dẫn bổ sung để thay đổi kích thước: giá trị trống yêu cầu mô hình giữ nội dung nguồn trung thực nhất có thể. Mọi hướng dẫn được cung cấp sẽ đi kèm lời nhắc thay đổi kích thước được tạo tự động và gửi đến nano-banana-pro.

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

URL hình ảnh nguồn để thay đổi kích thước.

resolution mặc định 1K

Gợi ý cấp độ độ phân giải nội bộ thiết lập mức tối thiểu, không phải kích thước cuối cùng được chỉ định bởi `target_sizes`. Nếu cấp độ đó không đáp ứng được kích thước yêu cầu, thay đổi kích thước thông minh có thể tự động chọn cấp độ cao hơn.

mặc định 1

Số biến thể cho mỗi kích thước của nano-banana-pro, xác định tổng số hình ảnh trả về là `len(target_sizes) * num_images_per_size`.

•bắt buộc

Kích thước đầu ra được yêu cầu dưới dạng danh sách các chuỗi `<width>x<height>`, ví dụ `"1920x1080"`. Mỗi mục tiêu được bao phủ bởi preset nano-banana-pro nhỏ nhất có thể nhưng vẫn đáp ứng kích thước được yêu cầu, cho kết quả khớp chính xác theo pixel mà không cần nâng cấp. Số lượng hình ảnh cho mỗi kích thước bằng một nhân với `num_images_per_size`.

Nâng cao output_format · safety_tolerance · seed
output_format mặc định png

Định dạng cho hình ảnh được tạo.

safety_tolerance mặc định 4

Mức dung sai an toàn: tăng số này khiến việc lọc bớt nghiêm ngặt hơn đối với các lệnh gọi /edit nội bộ của nano-banana-pro.

Seed tái lập tùy chọn được dùng chung cho tất cả kích thước mục tiêu. Khi được cung cấp, seed sẽ được truyền đến các lệnh gọi /edit nội bộ của nano-banana-pro.

POST /run/smart-resize?wait=20 báo giá → 0,50 $
# 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/smart-resize?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",
    "target_sizes": [
      "1024x1024",
      "1920x1080",
      "768x1344"
    ]
  }'

# 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ề Smart Resize

Thay đổi kích thước ảnh nguồn thành các kích thước tùy ý bằng cách tái tạo bố cục thay vì chỉ cắt ảnh. Cung cấp `target_sizes` gồm 1 đến 10 chuỗi như "1920x1080", với 1 đến 4 biến thể cho mỗi kích thước qua `num_images_per_size`. `prompt` tùy chọn dài tối đa 5000 ký tự có thể bổ sung hướng dẫn. `resolution` là 1K, 2K hoặc 4K, đầu ra là png, jpeg hoặc webp.

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_urlbắt buộc image
Kiểuurl · image
URL hình ảnh nguồn để thay đổi kích thước.
target_sizesbắt buộc
Kiểustring[]
≤ 10 mục
Kích thước đầu ra được yêu cầu dưới dạng danh sách các chuỗi `<width>x<height>`, ví dụ `"1920x1080"`. Mỗi mục tiêu được bao phủ bởi preset nano-banana-pro nhỏ nhất có thể nhưng vẫn đáp ứng kích thước được yêu cầu, cho kết quả khớp chính xác theo pixel mà không cần nâng cấp. Số lượng hình ảnh cho mỗi kích thước bằng một nhân với `num_images_per_size`.
prompttùy chọn
Kiểustring
Mặc định
≤ 5.000 ký tự
Hướng dẫn bổ sung để thay đổi kích thước: giá trị trống yêu cầu mô hình giữ nội dung nguồn trung thực nhất có thể. Mọi hướng dẫn được cung cấp sẽ đi kèm lời nhắc thay đổi kích thước được tạo tự động và gửi đến nano-banana-pro.
num_images_per_sizetùy chọn
Kiểuinteger
Mặc định1
1 – 4
Số biến thể cho mỗi kích thước của nano-banana-pro, xác định tổng số hình ảnh trả về là `len(target_sizes) * num_images_per_size`.
resolutiontùy chọn
Kiểuenum
Mặc định1K
1K2K4K
Gợi ý cấp độ độ phân giải nội bộ thiết lập mức tối thiểu, không phải kích thước cuối cùng được chỉ định bởi `target_sizes`. Nếu cấp độ đó không đáp ứng được kích thước yêu cầu, thay đổi kích thước thông minh có thể tự động chọn cấp độ cao hơn.
output_formattùy chọn
Kiểuenum
Mặc địnhpng
jpegpngwebp
Định dạng cho hình ảnh được tạo.
safety_tolerancetùy chọn
Kiểuenum
Mặc định4
123456
Mức dung sai an toàn: tăng số này khiến việc lọc bớt nghiêm ngặt hơn đối với các lệnh gọi /edit nội bộ của nano-banana-pro.
seedtùy chọn
Kiểuinteger | null
Seed tái lập tùy chọn được dùng chung cho tất cả kích thước mục tiêu. Khi được cung cấp, seed sẽ được truyền đến các lệnh gọi /edit nội bộ của nano-banana-pro.
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": "smart-resize",
  "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": 500,
    "usd": "0.50",
    "charged": 500,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "target_sizes": [
      "1024x1024",
      "1920x1080",
      "768x1344"
    ]
  },
  "output": {
    "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
      }
    ],
    "description": "string",
    "results": [
      {
        "images": [
          {}
        ],
        "description": "string",
        "width": 1024,
        "height": 768,
        "aspect_ratio": "string",
        "resolution": "string"
      }
    ]
  },
  "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
images
array of object {url, content_type, file_name, file_size, width, height}Danh sách hình ảnh kết hợp với các mục `num_images_per_size` đầu tiên cho `target_sizes[0]`, sau đó là các nhóm tương đương cho những `target_sizes` tiếp theo. Danh sách bao gồm mọi hình ảnh được tạo theo cùng thứ tự như `results`.
description
stringMô tả đi kèm các hình ảnh được tạo sinh.
results
array of object {images, description, width, height, aspect_ratio, resolution}Chiều rộng và chiều cao được yêu cầu cho từng mục tiêu, đi kèm preset nano-banana-pro được sử dụng trong quá trình xử lý, được xác định bởi aspect_ratio và độ phân giải.

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