Bỏ qua đến nội dung

Ideogram V3 Edit

Tích hợp

Id mô hình ideogram/v3/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ideogram/v3/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Yêu cầu này: 0,06 $ 60 tín dụng API · ≈ 6,33 ₽ 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

Nguồn tạo sinh được cung cấp dưới dạng URL hình ảnh, trong đó cả chiều rộng và chiều cao phải khớp chính xác với các kích thước tương ứng của mặt nạ.

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

Mặt nạ inpainting được cung cấp qua URL, trong đó cả chiều rộng và chiều cao phải khớp chính xác với các kích thước tương ứng của hình ảnh đầu vào.

rendering_speed mặc định BALANCED

Thiết lập tốc độ kết xuất.

num_images mặc định 1

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

Nâng cao images · style_preset · seed · expand_prompt · style_codes · color_palette
image_urls
Thả tệp hoặc

Hình ảnh tham chiếu phong cách ở định dạng JPEG, PNG hoặc WebP. Tổng kích thước không được vượt quá 10 MB.

Giá trị đặt trước về phong cách định hướng việc tạo sinh hình ảnh.

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

Mã phong cách hình ảnh, được cung cấp dưới dạng chuỗi thập lục phân dài 8 ký tự; bỏ qua cả style_reference_images và style khi sử dụng danh sách này.

Bảng màu được sử dụng trong quá trình tạo sinh. Chỉ định một preset qua name hoặc màu lục phân rõ ràng qua members, có thể kèm trọng số.

POST /run/ideogram/v3/edit?wait=20 báo giá → 0,06 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ideogram/v3/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.ru/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 V3 Edit

Điền vùng mặt nạ của ảnh theo `prompt`. Ảnh (`image_url`) và mặt nạ (`mask_url`) phải có kích thước giống hệt nhau. Có thể định hướng phong cách bằng ảnh tham chiếu, `style_codes`, `color_palette` hoặc `style_preset`. Tốc độ kết xuất là TURBO, BALANCED hoặc QUALITY, và có thể trả về 1 đến 8 ảnh.

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ả
image_urlstùy chọn images
Kiểuurl[] · image
Hình ảnh tham chiếu phong cách ở định dạng JPEG, PNG hoặc WebP. Tổng kích thước không được vượt quá 10 MB.
rendering_speedtùy chọn
Kiểuenum
Mặc địnhBALANCED
TURBOBALANCEDQUALITY
Thiết lập tốc độ kết xuất.
color_palettetùy chọn
Kiểuobject
Bảng màu được sử dụng trong quá trình tạo sinh. Chỉ định một preset qua name hoặc màu lục phân rõ ràng qua members, có thể kèm trọng số.
color_palette.memberstùy chọn
Kiểuobject[]
Danh sách thành phần bảng màu xác định các màu của bảng màu.
color_palette.members[].rgbbắt buộc
Kiểuobject
Màu của thành phần bảng màu được biểu thị dưới dạng RGB.
color_palette.members[].color_weighttùy chọn
Kiểunumber | null
Mặc định0.5
0,05 – 1
Trọng số gán cho màu này trong bảng màu.
color_palette.nametùy chọn
Kiểuenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Lựa chọn preset cho bảng màu.
style_codestùy chọn
Kiểustring[]
Mã phong cách hình ảnh, được cung cấp dưới dạng chuỗi thập lục phân dài 8 ký tự; bỏ qua cả style_reference_images và style khi sử dụng danh sách này.
expand_prompttùy chọn
Kiểuboolean
Mặc địnhtrue
Nút bật/tắt sử dụng MagicPrompt để tạo yêu cầu.
num_imagestùy chọn num_outputs
Kiểuinteger
Mặc định1
1 – 8
Số hình ảnh cần tạo.
seedtùy chọn
Kiểuinteger | null
Giá trị seed để tạo số ngẫu nhiên.
style_presettùy chọn
Kiểuenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 giá trị khácCOLORING_BOOK_ICOLORING_BOOK_IICUBISMDARK_AURADOODLEDOUBLE_EXPOSUREDRAMATIC_CINEMAEDITORIALEMOTIONAL_MINIMALETHEREAL_PARTYEXPIRED_FILMFLAT_ARTFLAT_VECTORFOREST_REVERIEGEO_MINIMALISTGLASS_PRISMGOLDEN_HOURGRAFFITI_IGRAFFITI_IIHALFTONE_PRINTHIGH_CONTRASTHIPPIE_ERAICONICJAPANDI_FUSIONJAZZYLONG_EXPOSUREMAGAZINE_EDITORIALMINIMAL_ILLUSTRATIONMIXED_MEDIAMONOCHROMENIGHTLIFEOIL_PAINTINGOLD_CARTOONSPAINT_GESTUREPOP_ARTRETRO_ETCHINGRIVIERA_POPSPOTLIGHT_80SSTYLIZED_REDSURREAL_COLLAGETRAVEL_POSTERVINTAGE_GEOVINTAGE_POSTERWATERCOLORWEIRDWOODBLOCK_PRINT
Giá trị đặt trước về phong cách định hướng việc tạo sinh hình ảnh.
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
Nguồn tạo sinh được cung cấp dưới dạng URL hình ảnh, trong đó cả chiều rộng và chiều cao phải khớp chính xác với các kích thước tương ứng của mặt nạ.
mask_urlbắt buộc mask
Kiểuurl · image
Mặt nạ inpainting được cung cấp qua URL, trong đó cả chiều rộng và chiều cao phải khớp chính xác với các kích thước tương ứng của hình ảnh đầu vào.
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/v3/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": 60,
    "usd": "0.06",
    "charged": 60,
    "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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/v3/edit.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt