หน้า API ของโมเดล
การเชื่อมต่อ API ของ 4o Image
ใช้ 4o Image ผ่าน Rivya Public API v1 ด้วย model id 4o-image, อินพุตที่รองรับ, พารามิเตอร์, กฎ Files API, เครดิต และตัวอย่างคำตอบ
พร้อมใช้งานผ่าน APIอินพุตข้อความพร้อมรูปภาพ
ID โมเดล API
4o-image
อินพุต
text
Files API
ไม่จำเป็นสำหรับคำขอขั้นต่ำ
เครดิตพื้นฐาน
3
ความสามารถ
รูปภาพ
การชำระเงิน
FIXED
ขีดจำกัดพรอมต์
ยังไม่มีขีดจำกัดพรอมต์ในเอกสาร
สัญญาของคำขอ
ส่ง model id ที่ระดับบนสุด การควบคุมเฉพาะโมเดลอยู่ใน params
| คีย์ | ประเภท | จำเป็น | ค่าเริ่มต้น | คำอธิบาย |
|---|---|---|---|---|
| model | string | ใช่ | 4o-image | ใช้ API model id 4o-image |
| prompt | string | ใช่ | - | ข้อความพรอมต์สำหรับโมเดลที่รองรับอินพุตแบบข้อความ |
| params | object | ไม่ใช่ | - | object พารามิเตอร์เฉพาะโมเดล ใช้แถวด้านล่างสำหรับ key ที่อนุญาต |
| client_request_id | string | ไม่ใช่ | - | ID ฝั่งไคลเอนต์แบบเลือกได้สำหรับติดตามคำขอในระบบของคุณ |
พารามิเตอร์โมเดล
| คีย์ | ประเภท | จำเป็น | ค่าเริ่มต้น | ช่วง | ตัวเลือก | คำอธิบาย |
|---|---|---|---|---|---|---|
| size | select | ไม่ใช่ | 1:1 | - | 1:1, 3:2, 2:3 | อัตราส่วนภาพ |
คำขอขั้นต่ำ
{
"model": "4o-image",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"size": "1:1"
}
}คำตอบจากการสร้าง
endpoint create ส่ง ID งานสาธารณะกลับมา ให้ตรวจ endpoint สถานะซ้ำจนกว่างานจะสำเร็จหรือล้มเหลว
{
"id": "task_4o_image_example",
"status": "queued",
"model": "4o-image",
"reserved_credits": 3,
"final_credits": 0,
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}ข้อผิดพลาดทั่วไป
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
endpoint create ส่ง ID งานสาธารณะกลับมา ให้ตรวจ endpoint สถานะซ้ำจนกว่างานจะสำเร็จหรือล้มเหลว