Bỏ qua đến nội dung

Image Outpaint

Tích hợp

Id mô hình image-apps-v2/outpaint
# 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/image-apps-v2/outpaint?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"
  }'

# 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,07 $ 70 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.

0 / 500

Hướng dẫn outpainting tùy chọn được thêm sau chỉ dẫn outpaint cơ sở, ví dụ: 'with a beautiful sunset in the background'.

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

URL của hình ảnh cần mở rộng bằng outpainting.

num_images mặc định 1

Số hình ảnh cần tạo.

Nâng cao output_format · expand_left · expand_right · expand_top · expand_bottom · zoom_out_percentage · seed · enable_safety_checker
output_format mặc định png

Định dạng tệp của hình ảnh kết quả.

mặc định 0

Phần mở rộng bên trái tính bằng pixel, được tô màu đen; chấp nhận 0–700.

mặc định 0

Phần mở rộng bên phải tính bằng pixel, được tô màu đen; chấp nhận 0–700.

mặc định 0

Phần mở rộng ở cạnh trên tính bằng pixel, được tô màu đen; chấp nhận 0–700.

mặc định 0

Phần mở rộng ở cạnh dưới tính bằng pixel, được tô màu đen; chấp nhận 0–700.

mặc định 20

Phần trăm thu nhỏ được áp dụng trong canvas không thay đổi: 50 giữ hình ảnh ở 50% kích thước ban đầu, bao quanh bởi màu đen. Khi được cung cấp, thiết lập này thu nhỏ hình ảnh theo tỷ lệ phần trăm đã chỉ định và lấp đầy khoảng trống bằng lề đen.

Seed cho hình ảnh có thể tái tạo: lời nhắc và seed giống hệt nhau sẽ tạo ra hình ảnh giống hệt khi phiên bản mô hình không đổi.

POST /run/image-apps-v2/outpaint?wait=20 báo giá → 0,07 $
# 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/image-apps-v2/outpaint?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"
  }'

# 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ề Image Outpaint

Mở rộng ảnh nguồn từ `image_url` bằng cách thiết lập `expand_left`, `expand_right`, `expand_top` và `expand_bottom`, mỗi giá trị từ 0 đến 700 pixel. Chỉ các phần lề được thêm vào mới được lấp đầy. `zoom_out_percentage` (0 đến 90, mặc định 20) thu nhỏ ảnh gốc trong khung trước, còn `prompt` tùy chọn tối đa 500 ký tự sẽ định hướng nội dung mới. Kết quả trả về từ 1 đến 4 ảnh ở định dạng png, jpeg, jpg 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 của hình ảnh cần mở rộng bằng outpainting.
expand_lefttùy chọn
Kiểuinteger
Mặc định0
0 – 700
Phần mở rộng bên trái tính bằng pixel, được tô màu đen; chấp nhận 0–700.
expand_righttùy chọn
Kiểuinteger
Mặc định0
0 – 700
Phần mở rộng bên phải tính bằng pixel, được tô màu đen; chấp nhận 0–700.
expand_toptùy chọn
Kiểuinteger
Mặc định0
0 – 700
Phần mở rộng ở cạnh trên tính bằng pixel, được tô màu đen; chấp nhận 0–700.
expand_bottomtùy chọn
Kiểuinteger
Mặc định0
0 – 700
Phần mở rộng ở cạnh dưới tính bằng pixel, được tô màu đen; chấp nhận 0–700.
zoom_out_percentagetùy chọn
Kiểunumber
Mặc định20
0 – 90
Phần trăm thu nhỏ được áp dụng trong canvas không thay đổi: 50 giữ hình ảnh ở 50% kích thước ban đầu, bao quanh bởi màu đen. Khi được cung cấp, thiết lập này thu nhỏ hình ảnh theo tỷ lệ phần trăm đã chỉ định và lấp đầy khoảng trống bằng lề đen.
prompttùy chọn
Kiểustring
Mặc định
≤ 500 ký tự
Hướng dẫn outpainting tùy chọn được thêm sau chỉ dẫn outpaint cơ sở, ví dụ: 'with a beautiful sunset in the background'.
seedtùy chọn
Kiểuinteger | null
Seed cho hình ảnh có thể tái tạo: lời nhắc và seed giống hệt nhau sẽ tạo ra hình ảnh giống hệt khi phiên bản mô hình không đổi.
num_imagestùy chọn num_outputs
Kiểuinteger
Mặc định1
1 – 4
Số hình ảnh cần tạo.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Kích hoạt trình kiểm tra an toàn; true bật kiểm tra.
output_formattùy chọn
Kiểuenum
Mặc địnhpng
pngjpegjpgwebp
Định dạng tệp của hình ảnh kết quả.
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": "image-apps-v2/outpaint",
  "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": 70,
    "usd": "0.07",
    "charged": 70,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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
      }
    ],
    "seed": 42
  },
  "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}Hình ảnh thể hiện cảnh được mở rộng bằng outpainting.
seed
integerGiá trị seed được áp dụng trong quá trình tạo sinh.

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/image-apps-v2/outpaint.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt