Bỏ qua đến nội dung

Playground v2.5 · Inpainting

Tích hợp

Id mô hình playground-v25/inpainting
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/playground-v25/inpainting?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",
    "mask": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Yêu cầu này: ≈0,004 $ 4 tín dụng API · ≈ 0,43 ₽ Chạy trên trang này

Lấy khóa API
Playground Chỉnh sửa hình ảnh #inpaint#artistic#style

Tô lại các vùng có mặt nạ của hình ảnh theo lời nhắc, sử dụng một hình ảnh mặt nạ riêng

Playground · 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

Mô tả hình ảnh bạn muốn tạo bằng càng nhiều chi tiết càng tốt để đạt kết quả tốt nhất.

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

Hình ảnh bắt đầu cho quá trình tạo sinh, được cung cấp qua URL.

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

URL trỏ đến mặt nạ inpainting.

image_size mặc định square_hd

Kích thước hình ảnh được tạo.

num_images mặc định 1

Số lượng hình ảnh yêu cầu tạo sinh.

Nâng cao negative_prompt · safety_checker_version · format · request_id · num_inference_steps · guidance_scale · strength · seed · enable_safety_checker · expand_prompt · embeddings
mặc định

Lời nhắc phủ định chỉ định các chi tiết hình ảnh không mong muốn. Có thể loại màu sắc, vật thể, phong cảnh hoặc các đặc điểm và phẩm chất nhỏ hơn, chẳng hạn như ria mép, mờ hoặc độ phân giải thấp.

safety_checker_version mặc định v1

Chọn giữa bộ kiểm tra an toàn ViT tùy chỉnh (`v2`) và bộ kiểm tra CompVis (`v1`, mặc định).

format mặc định jpeg

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

mặc định

Mã định danh yêu cầu dùng để liên kết phản hồi với yêu cầu đã tạo ra phản hồi đó.

mặc định 25

Số bước suy luận cần chạy.

mặc định 3

Mức độ tuân thủ lời nhắc khi chọn hình ảnh, được biểu thị bằng CFG (Classifier Free Guidance).

mặc định 0.95

Mức độ giống nhau giữa hình ảnh được tạo sinh và hình ảnh ban đầu.

Seed để tái tạo hình ảnh trong Stable Diffusion. Có thể tái tạo chính xác hình ảnh ở mỗi lần chạy bằng cách giữ nguyên phiên bản mô hình, lời nhắc và seed.

mặc định []

Các embedding được chọn để sử dụng, được cung cấp dưới dạng danh sách.

POST /run/playground-v25/inpainting?wait=20 báo giá → 0,004 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/playground-v25/inpainting?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",
    "mask": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/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ề Playground v2.5 · Inpainting

Yêu cầu `image_url`, `mask_url` và `prompt`, rồi tạo lại vùng được che. `strength` từ 0.01 đến 1, số bước suy luận từ 1 đến 65 và `guidance_scale` từ 0 đến 20. Có thể yêu cầu tối đa 8 ảnh đầu ra ở định dạng jpeg hoặc png. Cũng hỗ trợ `negative_prompt`, `seed`, embedding và các giá trị `image_size` dựng sẵn.

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
Hình ảnh bắt đầu cho quá trình tạo sinh, được cung cấp qua URL.
mask_urlbắt buộc mask
Kiểuurl · image
URL trỏ đến mặt nạ inpainting.
promptbắt buộc
Kiểustring
Mô tả hình ảnh bạn muốn tạo bằng càng nhiều chi tiết càng tốt để đạt kết quả tốt nhất.
negative_prompttùy chọn
Kiểustring
Mặc định
Lời nhắc phủ định chỉ định các chi tiết hình ảnh không mong muốn. Có thể loại màu sắc, vật thể, phong cảnh hoặc các đặc điểm và phẩm chất nhỏ hơn, chẳng hạn như ria mép, mờ hoặc độ phân giải thấp.
image_sizetùy chọn
Kiểuobject
Mặc địnhsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Kích thước hình ảnh được tạo.
num_inference_stepstùy chọn
Kiểuinteger
Mặc định25
1 – 65
Số bước suy luận cần chạy.
guidance_scaletùy chọn
Kiểunumber
Mặc định3
0 – 20
Mức độ tuân thủ lời nhắc khi chọn hình ảnh, được biểu thị bằng CFG (Classifier Free Guidance).
strengthtùy chọn
Kiểunumber
Mặc định0.95
0,01 – 1
Mức độ giống nhau giữa hình ảnh được tạo sinh và hình ảnh ban đầu.
seedtùy chọn
Kiểuinteger | null
Seed để tái tạo hình ảnh trong Stable Diffusion. Có thể tái tạo chính xác hình ảnh ở mỗi lần chạy bằng cách giữ nguyên phiên bản mô hình, lời nhắc và seed.
num_imagestùy chọn num_outputs
Kiểuinteger
Mặc định1
1 – 8
Số lượng hình ảnh yêu cầu tạo sinh.
embeddingstùy chọn
Kiểuobject[]
Mặc định[]
Các embedding được chọn để sử dụng, được cung cấp dưới dạng danh sách.
embeddings[].pathbắt buộc
Kiểustring
Trọng số embedding được chỉ định bằng URL hoặc đường dẫn tệp.
embeddings[].tokenstùy chọn
Kiểustring[]
Danh sách token embedding, với tính năng đặt tên tự động khi bỏ qua: mỗi vector trong tệp embedding nhận một token từ chuỗi <s0>, <s1>, ... .
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.
safety_checker_versiontùy chọn
Kiểuenum
Mặc địnhv1
v1v2
Chọn giữa bộ kiểm tra an toàn ViT tùy chỉnh (`v2`) và bộ kiểm tra CompVis (`v1`, mặc định).
expand_prompttùy chọn
Kiểuboolean
Mặc địnhfalse
Mở rộng lời nhắc bằng các lời nhắc bổ sung, được bật khi true.
formattùy chọn
Kiểuenum
Mặc địnhjpeg
jpegpng
Định dạng tệp của hình ảnh kết quả.
request_idtùy chọn
Kiểustring
Mặc định
Mã định danh yêu cầu dùng để liên kết phản hồi với yêu cầu đã tạo ra phản hồi đó.
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": "playground-v25/inpainting",
  "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": 4,
    "usd": "0.004",
    "charged": 4,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "width": 1024,
        "height": 768,
        "content_type": "image/jpeg"
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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, width, height, content_type}Thông tin tệp của các hình ảnh được tạo.
timings
object
seed
integerSeed tạo sinh hình ảnh, bao gồm giá trị được chọn ngẫu nhiên nếu đầu vào không cung cấp seed; nếu không, lặp lại giá trị đã cung cấp.
has_nsfw_concepts
array of booleanCho biết các khái niệm NSFW có xuất hiện trong hình ảnh được tạo sinh hay không.
prompt
stringLời nhắc được sử dụng trong quá trình tạo sinh hình ảnh.

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