Bỏ qua đến nội dung

Ideogram · v3 · Reframe

Tích hợp

Id mô hình ideogram/v3/reframe
# 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/v3/reframe?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",
    "image_size": "square_hd"
  }'

# 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,06 $ 60 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 image_url
Thả tệp hoặc

URL trỏ đến hình ảnh cần điều chỉnh khung.

rendering_speed mặc định BALANCED

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

image_size •bắt buộc

Độ phân giải của hình ảnh được tạo ra sau khi điều chỉnh khung.

num_images mặc định 1

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

Nâng cao images · style · style_preset · seed · 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.

style

Loại phong cách được sử dụng để tạo sinh; không thể dùng đồng thời với style_codes.

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/reframe?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.com/v1/run/ideogram/v3/reframe?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",
    "image_size": "square_hd"
  }'

# 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 · v3 · Reframe

Điều chỉnh khung của hình ảnh hiện có (`image_url`) theo `image_size` đích bắt buộc, chẳng hạn các thiết lập sẵn hình vuông, dọc hoặc ngang, đồng thời tạo nội dung mới để lấp đầy phần không gian bổ sung. Có thể điều chỉnh phong cách bằng hình ảnh tham chiếu, `style_codes`, `color_palette`, `style` hoặc `style_preset`. Hỗ trợ tốc độ TURBO, BALANCED hoặc QUALITY và 1 đến 8 đầu ra.

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.
styletùy chọn
Kiểuenum
AUTOGENERALREALISTICDESIGN
Loại phong cách được sử dụng để tạo sinh; không thể dùng đồng thời với style_codes.
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.
image_urlbắt buộc image
Kiểuurl · image
URL trỏ đến hình ảnh cần điều chỉnh khung.
image_sizebắt buộc
Kiểuobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Độ phân giải của hình ảnh được tạo ra sau khi điều chỉnh khung.
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/reframe",
  "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": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "image_size": "square_hd"
  },
  "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/v3/reframe.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt