เอกสาร Rivya AI
หน้า API ของโมเดล

การเชื่อมต่อ API ของ Infinitalk

ใช้ Infinitalk ผ่าน Rivya Public API v1 ด้วยรหัสโมเดล infinitalk, อินพุตที่รองรับ, พารามิเตอร์, กฎ Files API, เครดิต และตัวอย่างคำตอบ

พร้อมใช้งานผ่าน APIความพร้อมวิดีโอ
ID โมเดล API

infinitalk

อินพุต

file

Files API

จำเป็นสำหรับโหมดอ้างอิง

เครดิตพื้นฐาน

per_input_second · 480p=3 · 720p=12 · ⌈total⌉

ความสามารถ

วิดีโอ

การชำระเงิน

METERED

ขีดจำกัดพรอมต์

5000 อักขระ

สัญญาของคำขอ

ส่งรหัส `model` ที่ระดับบนสุด ส่วนการควบคุมเฉพาะโมเดลอยู่ใน `params`

คีย์ประเภทจำเป็นค่าเริ่มต้นคำอธิบาย
modelstringใช่infinitalkใช้รหัสโมเดล API infinitalk
promptstringใช่-สูงสุด 5000 อักขระสำหรับโมเดลนี้
paramsobjectไม่ใช่-อ็อบเจ็กต์พารามิเตอร์เฉพาะโมเดล ดูคีย์ที่อนุญาตได้จากแถวด้านล่าง
client_request_idstringไม่ใช่-ID ฝั่งไคลเอนต์แบบเลือกได้สำหรับติดตามคำขอในระบบของคุณ

พารามิเตอร์โมเดล

คีย์ประเภทจำเป็นค่าเริ่มต้นช่วงตัวเลือกคำอธิบาย
resolutionselectไม่ใช่480p-480p, 720pความละเอียด
seednumberไม่ใช่-min 10000 / max 1000000-เว้นว่างไว้เพื่อสร้างผลลัพธ์แบบสุ่มใหม่ทุกครั้ง การใช้เลขจำนวนเต็มเดิมซ้ำจะช่วยให้ทำซ้ำหรือปรับละเอียดจากผลลัพธ์ก่อนหน้าได้ง่ายขึ้น ผลลัพธ์จะใกล้เคียงขึ้นเมื่อพรอมป์และการตั้งค่าหลักอื่นยังคล้ายเดิมเท่านั้น และไม่รับประกันว่าจะตรงกันแบบ 1:1

นโยบายการอัปโหลด

อัปโหลดไฟล์อ้างอิงก่อน จากนั้นใส่ URL และโทเค็นระยะเวลาที่ได้กลับมาไว้ใน `params.referenceMediaItems`

กฎอ้างอิง

ภาพพอร์ตเทรตและเสียง: อัปโหลดภาพพอร์ตเทรตหนึ่งภาพและคลิปเสียงหนึ่งคลิปพร้อมกัน

ไฟล์สูงสุด

2

ชนิดไฟล์ที่รับ

image, audio

โทเค็นระยะเวลา

ไฟล์อ้างอิงวิดีโอและเสียงควรมี `durationToken` จาก /api/v1/files เมื่อจำเป็นต้องตรวจระยะเวลา

kindขนาดสูงสุดชนิด MIME
image10 MBimage/jpeg, image/png, image/webp
audio10 MBaudio/mpeg, audio/wav, audio/x-wav, audio/aac, audio/mp4, audio/ogg

คำขอขั้นต่ำ

{
  "model": "infinitalk",
  "params": {
    "resolution": "480p",
    "seed": 10000
  }
}

คำขอแบบไฟล์อ้างอิง

{
  "model": "infinitalk",
  "params": {
    "resolution": "480p",
    "seed": 10000,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

คำตอบจากการสร้าง

เอนด์พอยต์สำหรับสร้างงานจะส่ง ID งานสาธารณะกลับมา ให้ตรวจเอนด์พอยต์สถานะซ้ำจนกว่างานจะสำเร็จหรือล้มเหลว

{
  "id": "task_infinitalk_example",
  "status": "queued",
  "model": "infinitalk",
  "reserved_credits": 3,
  "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
}

ข้อผิดพลาดทั่วไป

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

บางโหมดต้องใช้การอัปโหลดไฟล์อ้างอิงผ่าน Files API