Bỏ qua đến nội dung

Ideogram · Custom Models · Generate

Tích hợp

Id mô hình ideogram/custom-models/generate
# 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/custom-models/generate?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_id": "your-model-id",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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,39 ₽ Chạy trên trang này

Lấy khóa API
Ideogram Văn bản sang hình ảnh #stylized#transform

Tạo ảnh từ mô hình Ideogram tùy chỉnh đã huấn luyện, được xác định bằng model_id

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

Mô tả bằng văn bản về hình ảnh đầu ra mong muốn.

rendering_speed mặc định BALANCED

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

•bắt buộc

ID mô hình tùy chỉnh từ /train, chỉ được chấp nhận sau khi mô hình đạt trạng thái đào tạo COMPLETED.

mặc định 1:1

Tỷ lệ khung hình của hình ảnh kết quả.

num_images mặc định 1

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

Nâng cao negative_prompt · seed · expand_prompt · enable_safety_checker
mặc định

Chỉ định nội dung hình ảnh cần loại trừ; các mô tả trong lời nhắc phủ định này sẽ phụ thuộc vào mọi mô tả trong lời nhắc chính.

Seed được bộ sinh số ngẫu nhiên sử dụng.

POST /run/ideogram/custom-models/generate?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/custom-models/generate?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_id": "your-model-id",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 · Custom Models · Generate

Chuyển văn bản thành ảnh bằng mô hình tùy chỉnh đã huấn luyện xong, được tham chiếu qua `model_id`, cùng `prompt`. `aspect_ratio` có 15 tùy chọn, `rendering_speed` là TURBO, BALANCED hoặc QUALITY, và `num_images` từ 1-8. Cũng hỗ trợ `negative_prompt`, `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ả
model_idbắt buộc
Kiểustring
ID mô hình tùy chỉnh từ /train, chỉ được chấp nhận sau khi mô hình đạt trạng thái đào tạo COMPLETED.
promptbắt buộc
Kiểustring
Mô tả bằng văn bản về hình ảnh đầu ra mong muốn.
aspect_ratiotùy chọn
Kiểuenum
Mặc định1:1
1:33:11:22:19:1616:910:1616:102:33:23:44:34:55:41:1
Tỷ lệ khung hình của hình ảnh kết quả.
rendering_speedtùy chọn
Kiểuenum
Mặc địnhBALANCED
TURBOBALANCEDQUALITY
Thiết lập tốc độ kết xuất.
num_imagestùy chọn num_outputs
Kiểuinteger
Mặc định1
1 – 8
Số hình ảnh cần tạo.
negative_prompttùy chọn
Kiểustring
Mặc định
Chỉ định nội dung hình ảnh cần loại trừ; các mô tả trong lời nhắc phủ định này sẽ phụ thuộc vào mọi mô tả trong lời nhắc chính.
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.
seedtùy chọn
Kiểuinteger | null
Seed được bộ sinh số ngẫu nhiên sử dụng.
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

Đầu ra

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/custom-models/generate",
  "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": {
    "model_id": "your-model-id",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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}Các hình ảnh được mô hình tạo sinh.
seed
integerGiá trị seed dùng để tạo số ngẫu nhiên.

Thêm mô hình: Văn bản sang 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/custom-models/generate.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt