Bỏ qua đến nội dung

Ideogram V2 Edit

Tích hợp

Id mô hình ideogram/v2/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/ideogram/v2/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",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "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,08 $ 80 tín dụng API Chạy trên trang này

Lấy khóa API
Ideogram · 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

Lời nhắc mô tả nội dung lấp đầy cho vùng được che của hình ảnh.

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

Cung cấp nguồn tạo sinh dưới dạng URL hình ảnh, đảm bảo hình ảnh nguồn và mặt nạ có kích thước giống hệt nhau.

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

Cung cấp mặt nạ lấp đầy qua URL, đảm bảo kích thước của mặt nạ bằng kích thước hình ảnh đầu vào.

Nâng cao style · seed · expand_prompt
style mặc định auto

Phong cách hình ảnh cho hình ảnh đầu ra.

Giá trị seed để tạo số ngẫu nhiên.

POST /run/ideogram/v2/edit?wait=20 báo giá → 0,08 $
# 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/ideogram/v2/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",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "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ề Ideogram V2 Edit

Chỉnh sửa ảnh bằng cách điền một vùng được che. Yêu cầu `image_url`, `mask_url` (cùng kích thước ảnh) và `prompt` cho phần cần điền. Tùy chọn `style` (auto, general, realistic, design, render_3D, anime), `expand_prompt` và `seed`.

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
Lời nhắc mô tả nội dung lấp đầy cho vùng được che của hình ảnh.
image_urlbắt buộc image
Kiểuurl · image
Cung cấp nguồn tạo sinh dưới dạng URL hình ảnh, đảm bảo hình ảnh nguồn và mặt nạ có kích thước giống hệt nhau.
mask_urlbắt buộc mask
Kiểuurl · image
Cung cấp mặt nạ lấp đầy qua URL, đảm bảo kích thước của mặt nạ bằng kích thước hình ảnh đầu vào.
seedtùy chọn
Kiểuinteger | null
Giá trị seed để tạo số ngẫu nhiên.
styletùy chọn
Kiểuenum
Mặc địnhauto
autogeneralrealisticdesignrender_3Danime
Phong cách hình ảnh cho hình ảnh đầu ra.
expand_prompttùy chọn
Kiểuboolean
Mặc địnhtrue
Kiểm soát việc MagicPrompt có mở rộng lời nhắc hay không.
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": "ideogram/v2/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": 80,
    "usd": "0.08",
    "charged": 80,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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"
  },
  "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
      }
    ],
    "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}
seed
integerGiá trị seed được sử dụng để tạo số ngẫu nhiên.

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