Tích hợp API Ideogram Character
Dùng Ideogram Character qua Rivya Public API v1 với ID mô hình ideogram-character, đầu vào được hỗ trợ, tham số, quy tắc Files API, tín dụng và ví dụ phản hồi.
ideogram-character
file
Bắt buộc cho chế độ tham chiếu
per_image · TURBO=12 · BALANCED=18 · QUALITY=24 · ⌈total⌉
Hình ảnh
FIXED
5000 ký tự
Quy ước yêu cầu
Gửi ID mô hình ở cấp trên cùng. Điều khiển riêng của mô hình nằm trong params.
| Key | Loại | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|---|
| model | string | Có | ideogram-character | Dùng ideogram-character làm ID mô hình API. |
| prompt | string | Có | - | Tối đa 5000 ký tự cho mô hình này. |
| params | object | Không | - | Đối tượng tham số riêng của mô hình. Dùng các dòng bên dưới để xem key được phép. |
| client_request_id | string | Không | - | ID phía client không bắt buộc để theo dõi yêu cầu trong hệ thống của bạn. |
Tham số mô hình
| Key | Loại | Bắt buộc | Mặc định | Phạm vi | Tùy chọn | Mô tả |
|---|---|---|---|---|---|---|
| rendering_speed | select | Không | BALANCED | - | TURBO, BALANCED, QUALITY | Cân bằng tốc độ, chi phí và chi tiết. Turbo nhanh nhất và rẻ nhất, Quality chi tiết nhất và đắt nhất, còn Balanced là mức giữa mặc định. |
| style | select | Không | AUTO | - | AUTO, REALISTIC, FICTION | Phong cách |
| expand_prompt | select | Không | true | - | true, false | Công tắc mở rộng prompt của Ideogram. Bật giúp mô hình phát triển mô tả của bạn đầy đủ hơn; tắt phù hợp hơn khi bạn muốn kiểm soát prompt chặt. |
| image_size | select | Không | square_hd | - | square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9 | Kích thước ảnh |
| num_images | select | Không | 1 | - | 1, 2, 3, 4 | Chọn 1–4 đầu ra. Tổng giá bằng đơn giá mỗi ảnh nhân với số lượng đã chọn rồi làm tròn lên credit nguyên. |
| seed | number | Không | - | - | - | Để trống để mỗi lần nhận một kết quả ngẫu nhiên mới. Dùng lại cùng một số nguyên sẽ giúp dễ tái tạo hoặc tinh chỉnh kết quả trước đó hơn. Kết quả chỉ gần hơn khi prompt và các thiết lập quan trọng khác cũng tương tự, và không đảm bảo khớp 1:1. |
| negative_prompt | text | Không | - | - | - | Prompt phủ định |
Chính sách tải lên
Trước tiên tải tệp tham chiếu lên, rồi đặt URL và duration token được trả về vào params.referenceMediaItems.
Ảnh tham chiếu nhân vật: Tải lên đúng 1 tệp ảnh cho dự án này.
1
image
Tham chiếu video và audio nên mang durationToken từ /api/v1/files khi cần xác minh thời lượng.
| kind | Kích thước tối đa | Loại MIME |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
Yêu cầu tối thiểu
{
"model": "ideogram-character",
"params": {
"rendering_speed": "BALANCED",
"style": "AUTO",
"expand_prompt": "true",
"image_size": "square_hd",
"num_images": "1",
"seed": 1,
"negative_prompt": "Nội dung tùy chọn cần tránh"
}
}Yêu cầu có tệp tham chiếu
{
"model": "ideogram-character",
"params": {
"rendering_speed": "BALANCED",
"style": "AUTO",
"expand_prompt": "true",
"image_size": "square_hd",
"num_images": "1",
"seed": 1,
"negative_prompt": "Nội dung tùy chọn cần tránh",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}Phản hồi tạo
Điểm cuối tạo trả về ID tác vụ công khai. Hãy thăm dò điểm cuối trạng thái cho đến khi tác vụ succeeded hoặc failed.
{
"id": "task_ideogram_character_example",
"status": "queued",
"model": "ideogram-character",
"reserved_credits": 18,
"final_credits": 0,
"settlement_status": "RESERVED",
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}Lỗi thường gặp
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Một số chế độ cần tải tệp tham chiếu qua Files API.