สร้างคีย์
ลงชื่อเข้าใช้ เปิดหน้าคีย์ API ในการตั้งค่า สร้างคีย์ที่มีขอบเขตสิทธิ์ และบันทึกข้อมูลลับแบบเต็มทันที
Rivya API
รูปแบบเริ่มต้นใช้งานด่วน
เลเยอร์โมเดล
แค็ตตาล็อกแบบไดนามิก
การคิดค่าใช้จ่าย
เครดิตร่วม
เวอร์ชันแรก
งานสร้าง + แชต
การเข้าถึง
คีย์ API
คำขอจริงต้องใช้คีย์ Rivya API และเครดิตบัญชีที่พร้อมใช้งาน ตัวอย่างสาธารณะใช้ข้อมูลลับตัวอย่างและไม่เรียกโมเดลสำหรับผู้ใช้ที่ไม่ระบุตัวตน
curl https://rivya.ai/api/v1/generations \
-H "Authorization: Bearer rvya_sk_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: demo-job-001" \
-d '{
"model": "z-image",
"prompt": "Editorial product photo on a clean studio set"
}'{
"id": "task_public_id",
"status": "queued",
"model": "z-image",
"reserved_credits": 1,
"result": null,
"error": null
}ตัวดีบักออนไลน์
เครื่องมือดีบักเริ่มในโหมดจำลองสำหรับผู้เยี่ยมชมทุกคน ตัวเลือกงานสร้างจะแสดงโมเดลที่ไม่ใช่แชตและทดสอบได้โดยไม่ต้องอัปโหลดไฟล์ ส่วนแผงไฟล์ให้ผู้ใช้ที่ลงชื่อเข้าใช้ทดสอบ `/api/v1/files` ด้วยคีย์ API ชั่วคราว โดยตัวอย่างแชตอยู่ในเอกสาร API
สถานะบัญชี
กำลังตรวจบัญชี
คำนำหน้าของคีย์ที่ใช้งานอยู่
สร้างคีย์ก่อน
เครดิตปัจจุบัน
ลงชื่อเข้าใช้เพื่อตรวจ
โหมดจำลองจะไม่เรียกโมเดลและไม่ใช้เครดิต
วางคีย์เฉพาะสำหรับคำขอนี้ ตัวดีบักจะไม่เก็บไว้หลังรีเฟรช
ทดสอบอัปโหลด Files API
อัปโหลดสื่ออ้างอิงผ่าน POST /api/v1/files จากนั้นคัดลอก URL และโทเค็นระยะเวลา (`duration_token`) ที่ได้กลับมาใส่ใน `params.referenceMediaItems` สำหรับโมเดลที่รองรับอินพุตอ้างอิง
โมเดลที่เลือกควบคุมชนิด MIME ขนาด และกฎระยะเวลาที่อนุญาต การอัปโหลดจริงต้องใช้คีย์ API ชั่วคราวของคุณและอาจเรียกบริการอัปโหลดจริง
{
"model": "z-image",
"prompt": "ภาพถ่ายผลิตภัณฑ์เชิงบรรณาธิการบนฉากสตูดิโอที่สะอาด",
"params": {
"aspect_ratio": "1:1"
}
}{
"id": "mock_task_001",
"status": "queued",
"model": "z-image",
"reserved_credits": 1,
"final_credits": 0,
"result": null,
"error": null
}{
"id": "file_mock_001",
"object": "file",
"kind": "image",
"file_name": "reference.png",
"mime_type": "image/png",
"size_bytes": 245760,
"url": "https://media.example/reference.png",
"duration_seconds": null,
"duration_token": null,
"created_at": "2026-05-11T00:00:00.000Z",
"expires_at": null
}{
"params": {
"referenceMediaItems": [
{
"url": "https://media.example/reference.png",
"kind": "image",
"name": "reference.png",
"mimeType": "image/png",
"sizeBytes": 245760
}
]
}
}สถานะงาน
เครดิตพื้นฐานโดยประมาณ
1
สถานะ
queued
เส้นทางเริ่มต้น
ลงชื่อเข้าใช้ เปิดหน้าคีย์ API ในการตั้งค่า สร้างคีย์ที่มีขอบเขตสิทธิ์ และบันทึกข้อมูลลับแบบเต็มทันที
อ่านข้อมูลอ้างอิงโมเดล API หรือเรียก `/api/v1/models` เพื่อตรวจรหัสโมเดล พารามิเตอร์ ความสามารถด้านแชต และความพร้อมของอินพุตก่อนส่งงาน
ส่งคำขอสร้างงานที่ป้องกันการทำซ้ำ ตรวจจุดเชื่อมต่องานสาธารณะซ้ำ ใช้เว็บฮุกที่ลงลายเซ็นเพื่อรับผลของงานสร้าง หรือส่งการสนทนาผ่าน Chat API พร้อมเลือกสตรีมผ่าน SSE ได้
สิ่งที่จะปล่อยก่อน
API เป็นส่วนหนึ่งของผลิตภัณฑ์ Rivya โดยใช้รหัสโมเดล เครดิต และสถานะงานสาธารณะชุดเดียวกัน พร้อมเอกสารที่เชื่อมกับแค็ตตาล็อกโมเดล
ส่งงานภาพพร้อมพรอมต์และพารามิเตอร์โมเดลที่รองรับ จากนั้นตรวจสถานะซ้ำเพื่อรับผลลัพธ์สาธารณะ
รันงานวิดีโอแบบอะซิงโครนัสด้วยการควบคุมงานและเครดิตชุดเดียวกับที่ Studio ใช้
ใช้โมเดลเสียงที่เข้าถึงผ่าน API ได้ ภายใต้บัญชี ยอดคงเหลือ และขอบเขตประวัติเดียวกัน
การเรียก API และการใช้งาน Studio ดึงจากยอด Rivya เดียวกัน พร้อมเครดิตที่กันไว้และการจัดการเมื่อเกิดความล้มเหลว
ขอบเขตเวอร์ชัน
หน้านี้แยกความสามารถของ API ที่พร้อมใช้งานออกจากสิ่งที่จะเพิ่มในอนาคตอย่างชัดเจน เพื่อให้คุณวางแผนตามสิ่งที่ใช้งานได้จริงในวันนี้
พร้อมใช้งานสำหรับการสนทนาแบบไม่สตรีมและการสตรีมผ่าน SSE พร้อมเซสชันที่สร้างผ่าน API เครดิตบัญชี และไฟล์ภาพแนบจาก Files API ที่เลือกใช้ได้
พร้อมใช้งานสำหรับอัปโหลดภาพ วิดีโอ และเสียงอ้างอิง โดยใช้ก่อนสร้างงานเมื่อหน้าโมเดลต้องการ `params.referenceMediaItems`
พร้อมใช้งานสำหรับระบบจริงที่ต้องรับการเรียกกลับแบบลงลายเซ็น เมื่องานสร้างสำเร็จหรือล้มเหลว
อ่านเรื่องการยืนยันตัวตน เนื้อหาคำขอ คำตอบ การป้องกันคำขอซ้ำ พารามิเตอร์โมเดล และรหัสข้อผิดพลาด
เปิดเอกสารสร้างคีย์ API และคัดลอกเก็บไว้ได้เพียงครั้งเดียว เมื่อต้องการเปลี่ยนคีย์ ให้สร้างรายการใหม่แล้วเพิกถอนรายการเดิมในหน้าการตั้งค่าที่มีการป้องกัน
จัดการคีย์ลองตัวอย่างจำลองก่อน การดีบักแบบใช้งานจริงต้องเข้าสู่ระบบ มีคีย์ API และมีเครดิตบัญชี
ดูตัวอย่างขั้นตอน