Bỏ qua đến nội dung

Ideogram V4.0q Image to Image

Tích hợp

Id mô hình ideogram/v4/image-to-image
# 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/v4/image-to-image?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"
  }'

# 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"

Các tệp như ví dụ: 0,015 $ 15 tín dụng API · ≈ 1,58 ₽ tệp của bạn được đo trước khi chạy 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 định hướng việc tạo sinh hình ảnh.

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

URL hình ảnh nguồn dùng cho việc tạo sinh hình ảnh từ hình ảnh.

image_size mặc định auto

Đặt kích thước đầu ra hoặc chọn 'auto' để giữ kích thước đầu vào trong các giới hạn sau: tổng cộng khoảng 25MP và tối đa 8192px ở mỗi cạnh.

rendering_speed mặc định BALANCED

Thiết lập tốc độ kết xuất; các tùy chọn nhanh hơn thực hiện ít bước khử nhiễu hơn.

num_images mặc định 1

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

Nâng cao expansion_model · acceleration · output_format · strength · seed · enable_safety_checker
expansion_model mặc định Medium

Chọn mô hình mở rộng lời nhắc: 'Large' cung cấp chất lượng cao nhất thông qua Magic Prompt của Ideogram, còn 'Medium' ưu tiên tốc độ. Chọn 'None' để giữ nguyên lời nhắc không mở rộng.

acceleration mặc định none

Thiết lập tăng tốc khi tạo sinh hình ảnh.

output_format mặc định jpeg

Định dạng tệp của hình ảnh kết quả.

mặc định 0.8

Mức độ biến đổi hình ảnh: các thiết lập nhỏ hơn giữ kết quả gần nguồn hơn, trong khi ở 1.0 nguồn không có ảnh hưởng.

Seed cho việc tạo sinh, được chọn ngẫu nhiên trừ khi bạn cung cấp giá trị.

POST /run/ideogram/v4/image-to-image?wait=20 báo giá → 0,015 $
# 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/v4/image-to-image?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"
  }'

# 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 V4.0q Image to Image

Biến đổi ảnh đầu vào (`image_url`) bằng `prompt`. `strength` từ 0 đến 1 (mặc định 0.8), trong đó 1.0 bỏ qua ảnh đầu vào. `image_size` mặc định là auto, khớp với ảnh nguồn. Cũng cung cấp `expansion_model`, `rendering_speed`, `acceleration`, 1 đến 4 đầu ra và định dạng JPEG hoặc PNG.

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 định hướng việc tạo sinh hình ảnh.
expansion_modeltùy chọn
Kiểuenum
Mặc địnhMedium
NoneMediumLarge
Chọn mô hình mở rộng lời nhắc: 'Large' cung cấp chất lượng cao nhất thông qua Magic Prompt của Ideogram, còn 'Medium' ưu tiên tốc độ. Chọn 'None' để giữ nguyên lời nhắc không mở rộng.
image_sizetùy chọn
Kiểuobject
Mặc địnhauto
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9auto
Đặt kích thước đầu ra hoặc chọn 'auto' để giữ kích thước đầu vào trong các giới hạn sau: tổng cộng khoảng 25MP và tối đa 8192px ở mỗi cạnh.
rendering_speedtùy chọn
Kiểuenum
Mặc địnhBALANCED
TURBOBALANCEDQUALITY
Thiết lập tốc độ kết xuất; các tùy chọn nhanh hơn thực hiện ít bước khử nhiễu hơn.
accelerationtùy chọn
Kiểuenum
Mặc địnhnone
nonelowregularhigh
Thiết lập tăng tốc khi tạo sinh hình ảnh.
num_imagestùy chọn num_outputs
Kiểuinteger
Mặc định1
1 – 4
Số hình ảnh cần tạo.
seedtùy chọn
Kiểuinteger | null
Seed cho việc tạo sinh, được chọn ngẫu nhiên trừ khi bạn cung cấp giá trị.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Công tắc kiểm tra an toàn, trong đó trạng thái tắt yêu cầu ủy quyền tài khoản. Nếu không có ủy quyền, mọi yêu cầu đều được kiểm tra bất kể cài đặt; true bật trình kiểm tra.
output_formattùy chọn
Kiểuenum
Mặc địnhjpeg
jpegpng
Định dạng tệp của hình ảnh kết quả.
image_urlbắt buộc image
Kiểuurl · image
URL hình ảnh nguồn dùng cho việc tạo sinh hình ảnh từ hình ảnh.
strengthtùy chọn
Kiểunumber
Mặc định0.8
0 – 1
Mức độ biến đổi hình ảnh: các thiết lập nhỏ hơn giữ kết quả gần nguồn hơn, trong khi ở 1.0 nguồn không có ảnh hưở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/v4/image-to-image",
  "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": 15,
    "usd": "0.015",
    "charged": 15,
    "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"
  },
  "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
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "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, width, height}Các hình ảnh được mô hình tạo sinh.
timings
object
seed
integerSeed tạo sinh hình ảnh, bao gồm giá trị được chọn ngẫu nhiên nếu đầu vào không cung cấp seed; nếu không, lặp lại giá trị đã cung cấp.
has_nsfw_concepts
array of booleanCho biết các khái niệm NSFW có xuất hiện trong hình ảnh được tạo sinh hay không.
prompt
stringLời nhắc được sử dụng trong quá trình tạo sinh hình ảnh.

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