Bỏ qua đến nội dung

Hunyuan Image · v3 · Instruct · Edit

Tích hợp

Id mô hình hunyuan-image/v3/instruct/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/hunyuan-image/v3/instruct/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,174 $ 174 tín dụng API Chạy trên trang này

Lấy khóa API
Tencent Chỉnh sửa hình ảnh #tencent#hunyuan-image#instruct#edit

Chỉnh sửa hình ảnh dựa trên chỉ dẫn từ tối đa 3 hình ảnh tham chiếu, với tùy chọn mở rộng lời nhắc

Tencent · 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 sinh hình ảnh.

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

Cung cấp các tham chiếu tạo sinh bằng URL, với tối đa 3 hình ảnh trong danh sách.

image_size mặc định auto

Kích thước hình ảnh đầu ra, được yêu cầu rõ ràng hoặc do mô hình chọn khi đặt là auto.

num_images mặc định 1

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

Nâng cao output_format · guidance_scale · seed · enable_prompt_expansion · 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 3.5

Mức độ tuân theo lời nhắc: tăng giá trị này để mô hình tuân theo lời nhắc nghiêm ngặt hơn.

Seed để tái lập; None cho phép hệ thống chọn ngẫu nhiên thay vì dùng giá trị do bên gọi chỉ định.

POST /run/hunyuan-image/v3/instruct/edit?wait=20 báo giá → 0,174 $
# 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/hunyuan-image/v3/instruct/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ề Hunyuan Image · v3 · Instruct · Edit

Chỉnh sửa hình ảnh theo `prompt` văn bản, sử dụng một đến ba hình ảnh tham chiếu trong `image_urls`. `image_size` mặc định là auto để mô hình chọn kích thước đầu ra. Có thể trả về tối đa 4 hình ảnh, `guidance_scale` nằm trong khoảng 1 đến 20 và mở rộng lời nhắc được bật theo mặc định. Đầu ra là 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ả
promptbắt buộc
Kiểustring
Hướng dẫn bằng văn bản để tạo sinh hình ảnh.
image_sizetùy chọn
Kiểuobject
Mặc địnhauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Kích thước hình ảnh đầu ra, được yêu cầu rõ ràng hoặc do mô hình chọn khi đặt là auto.
num_imagestùy chọn num_outputs
Kiểuinteger
Mặc định1
1 – 4
Số lượng hình ảnh yêu cầu tạo sinh.
guidance_scaletùy chọn
Kiểunumber
Mặc định3.5
≤ 20> 1
Mức độ tuân theo lời nhắc: tăng giá trị này để mô hình tuân theo lời nhắc nghiêm ngặt hơn.
enable_prompt_expansiontùy chọn
Kiểuboolean
Mặc địnhtrue
Mở rộng lời nhắc thông qua việc mô hình nội bộ tạo lại chú thích, được bật khi đặt là true.
seedtùy chọn
Kiểuinteger | null
Seed để tái lập; None cho phép hệ thống chọn ngẫu nhiên thay vì dùng giá trị do bên gọi chỉ định.
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
jpegpng
Định dạng tệp của hình ảnh kết quả.
image_urlsbắt buộc images
Kiểuurl[] · image
Cung cấp các tham chiếu tạo sinh bằng URL, với tối đa 3 hình ảnh trong danh sách.
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": "hunyuan-image/v3/instruct/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": 174,
    "usd": "0.174",
    "charged": 174,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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
  },
  "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 chứa các hình ảnh đã tạo.
seed
integerSeed cơ sở được sử 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/hunyuan-image/v3/instruct/edit.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt