Bỏ qua đến nội dung

Hidream O1 Image · Dev · Edit

Tích hợp

Id mô hình hidream-o1-image/dev/edit
# 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/hidream-o1-image/dev/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "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,02 $ 20 tín dụng API Chạy trên trang này

Lấy khóa API
HiDream Chỉnh sửa hình ảnh Đầu vào tham chiếu

Biến thể dev chưng cất để chỉnh sửa hình ảnh tham chiếu, 28 bước và hướng dẫn 0 theo mặc định

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

Hướng dẫn bằng văn bản để tạo hoặc chỉnh sửa hình ảnh, hoặc cá nhân hóa dựa trên chủ thể.

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

Hình ảnh được cung cấp làm tham chiếu để chỉnh sửa hoặc cá nhân hóa dựa trên chủ thể.

image_size mặc định {"height":2048,"width...

Chọn kích thước hình ảnh; với đầu ra dựa trên hình ảnh tham chiếu, yêu cầu này được khớp với độ phân giải gần nhất mà mô hình hỗ trợ, tối đa gần đúng 2048 × 2048 pixel.

num_images mặc định 1

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

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

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

mặc định 28

Số vòng lặp khử nhiễu, trong đó 28 bước khớp với mục tiêu chưng cất của mô hình dev.

mặc định 0

Tỷ lệ hướng dẫn không dùng bộ phân loại; mặc định là 0.0 cho mô hình dev.

Seed ngẫu nhiên giúp tái tạo kết quả tạo sinh.

POST /run/hidream-o1-image/dev/edit?wait=20 báo giá → 0,02 $
# 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/hidream-o1-image/dev/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "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ề Hidream O1 Image · Dev · Edit

Chỉnh sửa hoặc cá nhân hóa hình ảnh từ các hình ảnh tham chiếu (`reference_image_urls`) và `prompt` văn bản, bằng mô hình dev chưng cất được tinh chỉnh cho 28 bước với tỷ lệ hướng dẫn mặc định 0. Đầu ra lên đến khoảng 2048x2048 qua các thiết lập sẵn về kích thước hoặc kích thước tùy chỉnh. Trả về 1 đến 4 hình ảnh ở dạng PNG, JPEG hoặc WebP, còn `keep_original_aspect` giữ hình dạng của một tham chiếu duy nhất.

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ả
promptbắt buộc
Kiểustring
Hướng dẫn bằng văn bản để tạo hoặc chỉnh sửa hình ảnh, hoặc cá nhân hóa dựa trên chủ thể.
reference_image_urlsbắt buộc images
Kiểuurl[] · image
Hình ảnh được cung cấp làm tham chiếu để chỉnh sửa hoặc cá nhân hóa dựa trên chủ thể.
image_sizetùy chọn
Kiểuobject
Mặc định{"height":2048,"width":2048}
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Chọn kích thước hình ảnh; với đầu ra dựa trên hình ảnh tham chiếu, yêu cầu này được khớp với độ phân giải gần nhất mà mô hình hỗ trợ, tối đa gần đúng 2048 × 2048 pixel.
num_inference_stepstùy chọn
Kiểuinteger
Mặc định28
1 – 28
Số vòng lặp khử nhiễu, trong đó 28 bước khớp với mục tiêu chưng cất của mô hình dev.
guidance_scaletùy chọn
Kiểunumber
Mặc định0
0 – 20
Tỷ lệ hướng dẫn không dùng bộ phân loại; mặc định là 0.0 cho mô hình dev.
seedtùy chọn
Kiểuinteger | null
Seed ngẫu nhiên giúp tái tạo kết quả tạo sinh.
num_imagestùy chọn num_outputs
Kiểuinteger
Mặc định1
1 – 4
Số hình ảnh cần tạo.
output_formattùy chọn
Kiểuenum
Mặc địnhpng
jpegpngwebp
Định dạng tệp của hình ảnh kết quả.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Kiểm soát việc hình ảnh được tạo có trải qua kiểm tra an toàn hay không.
keep_original_aspecttùy chọn
Kiểuboolean
Mặc địnhfalse
Giữ tỷ lệ khung hình khi tạo từ một tham chiếu: đầu ra chỉ khớp tỷ lệ của tham chiếu khi cung cấp chính xác một hình ảnh.
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": "hidream-o1-image/dev/edit",
  "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": 20,
    "usd": "0.02",
    "charged": 20,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "reference_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.
seed
integerGiá trị seed được áp dụng trong quá trình tạo sinh.
has_nsfw_concepts
array of booleanTrạng thái cờ kiểm tra an toàn cho từng hình ảnh được tạo.
prompt
stringLời nhắc đã được dùng để tạo đầu ra.
timings
objectCác phép đo thời gian cho quá trình tạo sinh.

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