Bỏ qua đến nội dung

Marigold V2 Depth

Tích hợp

Id mô hình marigold-v2
# 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/marigold-v2?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,03 $ 30 tín dụng API Chạy trên trang này

Lấy khóa API
Open model Chỉnh sửa hình ảnh #depth#utility

Mô hình phân tích hình ảnh xuất bản đồ độ sâu, độ sâu xuyên thấu, pháp tuyến hoặc albedo từ một ảnh

Open model · 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 image_url
Thả tệp hoặc

URL của hình ảnh đầu vào.

image_size

Kích thước suy luận; nếu bỏ qua, kích thước của hình ảnh đầu vào sẽ được dùng sau khi làm tròn từng chiều đến bội số gần nhất của 16. Chỉ định preset như `"square_hd"` hoặc `"landscape_4_3"`, hoặc cung cấp đối tượng `{width, height}`. Chiều rộng và chiều cao đều phải chia hết cho 16, không chiều nào được vượt quá 2048 pixel và tỷ lệ phải nằm trong khoảng 1:16 đến 16:1.

Nâng cao prediction_type · seed · enable_safety_checker
prediction_type mặc định depth

Loại bản đồ dự đoán cần tạo.

Seed ngẫu nhiên giúp tái tạo đầu ra khi dùng lại cùng hình ảnh. Ảnh hưởng của seed chỉ giới hạn ở việc lấy mẫu latent của bộ mã hóa VAE, vì lượt truyền xuôi vốn chỉ là một bước tất định.

POST /run/marigold-v2?wait=20 báo giá → 0,03 $
# 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/marigold-v2?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ề Marigold V2 Depth

Ước tính bản đồ từ một hình ảnh duy nhất. `prediction_type` chọn độ sâu, độ sâu xuyên thấu, pháp tuyến hoặc albedo. Kết quả là hình ảnh PNG trực quan hóa thay vì tensor số. `image_size` có thể là giá trị đặt trước hoặc đối tượng chiều rộng/chiều cao với các bội số của 16 lên đến 2048, còn `seed` giúp kết quả có thể lặp lại.

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ả
prediction_typetùy chọn
Kiểuenum
Mặc địnhdepth
depthsee-through-depthnormalsalbedo
Loại bản đồ dự đoán cần tạo.
image_urlbắt buộc image
Kiểuurl · image
URL của hình ảnh đầu vào.
image_sizetùy chọn
Kiểuobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Kích thước suy luận; nếu bỏ qua, kích thước của hình ảnh đầu vào sẽ được dùng sau khi làm tròn từng chiều đến bội số gần nhất của 16. Chỉ định preset như `"square_hd"` hoặc `"landscape_4_3"`, hoặc cung cấp đối tượng `{width, height}`. Chiều rộng và chiều cao đều phải chia hết cho 16, không chiều nào được vượt quá 2048 pixel và tỷ lệ phải nằm trong khoảng 1:16 đến 16:1.
seedtùy chọn
Kiểuinteger | null
Seed ngẫu nhiên giúp tái tạo đầu ra khi dùng lại cùng hình ảnh. Ảnh hưởng của seed chỉ giới hạn ở việc lấy mẫu latent của bộ mã hóa VAE, vì lượt truyền xuôi vốn chỉ là một bước tất định.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Có thể nới lỏng việc kiểm duyệt bằng cách đặt thành false, nếu người gọi được cấp quyề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": "marigold-v2",
  "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": 30,
    "usd": "0.03",
    "charged": 30,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "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
image
object {url, content_type, file_name, file_size, width, height}Dự đoán được kết xuất dưới dạng PNG để xem; phản hồi không cung cấp tensor số không mất dữ liệu thông qua hình ảnh này.
seed
integerSeed được áp dụng khi lấy mẫu latent trong bộ mã hóa VAE.

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