Bỏ qua đến nội dung

Uso

Tích hợp

Id mô hình uso
# 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/uso?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_urls": [
      "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,10 $ 100 tín dụng API Chạy trên trang này

Lấy khóa API
ByteDance Chỉnh sửa hình ảnh #image-to-image

Tạo ảnh theo phong cách và chủ thể từ ảnh nội dung cùng một hoặc hai ảnh phong cách

ByteDance · 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.

mặc định

Văn bản lời nhắc tạo sinh; để trống để chỉ thực hiện chuyển kiểu.

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

Danh sách URL hình ảnh theo thứ tự: [content_image, style_image, extra_style_image].

image_size mặc định square_hd

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

num_images mặc định 1

Số hình ảnh được tạo đồng thời.

Nâng cao negative_prompt · output_format · num_inference_steps · guidance_scale · seed · keep_size · enable_safety_checker
mặc định

Nội dung hình ảnh không mong muốn cần loại trừ, bao gồm các thành phần, kiểu và hiện vật.

output_format mặc định png

Định dạng hình ảnh đầu ra: PNG giữ độ trong suốt, còn JPEG tạo tệp nhỏ hơn.

mặc định 28

Số vòng lặp khử nhiễu, đánh đổi thời gian tạo sinh lâu hơn để có chất lượng tiềm năng tốt hơn khi số vòng tăng.

mặc định 4

Kiểm soát mức độ tuân thủ lời nhắc: tăng giá trị này để kết quả bám sát lời nhắc hơn.

Seed kiểm soát tính ngẫu nhiên của quá trình tạo sinh. Sử dụng lại seed sẽ tạo ra kết quả nhất quán, có thể tái lập.

POST /run/uso?wait=20 báo giá → 0,10 $
# 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/uso?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_urls": [
      "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ề Uso

Nhận `input_image_urls` theo thứ tự: hình ảnh nội dung, hình ảnh kiểu và hình ảnh kiểu bổ sung tùy chọn. Lời nhắc có thể để trống để chuyển kiểu thuần túy, còn `negative_prompt` loại trừ các thành phần không mong muốn. `keep_size` giữ nguyên bố cục và kích thước của hình ảnh nội dung. Mỗi lần chạy tạo từ 1 đến 4 hình ảnh, với 1 đến 50 bước và đầu ra PNG hoặc JPEG.

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ả
prompttùy chọn
Kiểustring
Mặc định
Văn bản lời nhắc tạo sinh; để trống để chỉ thực hiện chuyển kiểu.
input_image_urlsbắt buộc
Kiểuurl[] · image
Danh sách URL hình ảnh theo thứ tự: [content_image, style_image, extra_style_image].
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.
negative_prompttùy chọn
Kiểustring
Mặc định
Nội dung hình ảnh không mong muốn cần loại trừ, bao gồm các thành phần, kiểu và hiện vật.
num_inference_stepstùy chọn
Kiểuinteger
Mặc định28
1 – 50
Số vòng lặp khử nhiễu, đánh đổi thời gian tạo sinh lâu hơn để có chất lượng tiềm năng tốt hơn khi số vòng tăng.
guidance_scaletùy chọn
Kiểunumber
Mặc định4
1 – 10
Kiểm soát mức độ tuân thủ lời nhắc: tăng giá trị này để kết quả bám sát lời nhắc hơn.
keep_sizetùy chọn
Kiểuboolean
Mặc địnhfalse
Giữ nguyên kích thước và bố cục của hình ảnh nội dung khi xử lý, hữu ích cho việc chuyển kiểu.
num_imagestùy chọn num_outputs
Kiểuinteger
Mặc định1
1 – 4
Số hình ảnh được tạo đồng thời.
seedtùy chọn
Kiểuinteger | null
Seed kiểm soát tính ngẫu nhiên của quá trình tạo sinh. Sử dụng lại seed sẽ tạo ra kết quả nhất quán, có thể tái lập.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Bật phát hiện và lọc nội dung NSFW.
output_formattùy chọn
Kiểuenum
Mặc địnhpng
jpegpng
Định dạng hình ảnh đầu ra: PNG giữ độ trong suốt, còn JPEG tạo tệp nhỏ hơn.
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": "uso",
  "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": 100,
    "usd": "0.10",
    "charged": 100,
    "refunded": 0
  },
  "input": {
    "input_image_urls": [
      "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,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string",
    "timings": {}
  },
  "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}Các hình ảnh được tạo sinh có tùy chỉnh kiểu, tùy chỉnh chủ thể hoặc cả hai.
seed
integerGiá trị seed được dùng trong quá trình tạo sinh.
has_nsfw_concepts
array of booleanKết quả phát hiện NSFW theo từng hình ảnh trên các hình ảnh được tạo sinh.
prompt
stringLời nhắc đã được dùng trong quá trình tạo sinh.
timings
objectCác phép đo thời gian hiệu năng được phân tách theo giai đoạn.

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