// คู่มือ API

เชื่อมต่อ API (v1)

ต่อ n8n / ระบบอัตโนมัติด้วย เครดิตก้อนเดียวกับหน้าเว็บ — ไม่ต้องสมัคร kie.ai ไม่ต้องเติมเงินแยก เรียกทุกเครื่องมือ AI ผ่าน endpoint เดียว

1. เริ่มใช้

ไป หน้า API ของฉัน → สร้าง key (aiwork_live_…) — โชว์ครั้งเดียว คัดลอกเก็บทันที
ทุก request ใส่ header: Authorization: Bearer aiwork_live_xxxxx

2. Endpoint เดียวจบ

POST https://aiwork.furredco.com/api/v1/run
Content-Type: application/json

{
  "action": "topaz_4x",
  "input": { "image_url": "https://…/photo.jpg" },
  "idempotency_key": "uuid-กันยิงซ้ำ"
}

action	ทำอะไร	เครดิต	input
caption	เจนแคปชั่นขายของ	1	brief (จำเป็น), platforms[], count, tone, audience
content_factory	แคปชั่น + โปสเตอร์	12	page_desc + audience (จำเป็น), details, tone
topaz_2x	อัปภาพคม 2x	6	image_url (https)
topaz_4x	อัปภาพคม 4x	12	image_url
topaz_8x	อัปภาพคม 8x	25	image_url — ด้านยาว ≤ 2,500px

caption ตอบผลทันที (status: "success") · งานภาพเป็น async — ตอบ status: "processing" + task_id แล้ว poll ต่อ:

GET https://aiwork.furredco.com/api/v1/task?task_id=xxx
Authorization: Bearer aiwork_live_xxxxx

→ { "ok": true, "status": "success",
    "result": { "url": "https://…" }, "credits_left": 172 }

status processing → poll ต่อทุก 3–5 วิ · failed → เครดิตคืนอัตโนมัติ

3. Meeting API — สรุปประชุม

ใช้ key เดิมกับเว็บได้เลย ระบบ hold เครดิตจากเวลาประเมิน แล้วปรับตามความยาวจริงหลังถอดเสียง สำเร็จ ล้มเหลว และ retry ทั้งหมดใช้ job เดิม ไม่หักซ้ำ

# 1) ขอ signed upload URL (durationEstimateSec ไม่บังคับสำหรับ API key)
POST /api/meeting/upload-url
Authorization: Bearer aiwork_live_xxxxx
Content-Type: application/json

{ "name": "meeting.m4a", "type": "audio/mp4", "size": 5242880, "mode": "paid" }
→ { "path": "user-id/uuid", "uploadUrl": "https://…", "durationEstimateSec": 1500 }

# 2) PUT binary ไป uploadUrl แล้วสร้าง job
POST /api/meeting/jobs
{ "storagePath": "user-id/uuid", "filename": "meeting.m4a",
  "mime": "audio/mp4", "size": 5242880, "mode": "paid" }

# 3) poll
GET /api/meeting/jobs/{jobId}

API key ใช้ paid mode เท่านั้น; free trial ต้องเริ่มจาก web session
รองรับ MP3, M4A, WAV, MP4, MOV, WEBM · ไม่เกิน 500MB และ 4 ชั่วโมง
ถ้าไม่ส่ง durationEstimateSec ระบบประเมินแบบเผื่อสูงจากขนาดไฟล์ แล้วคืน/ปรับเครดิตจากเวลาจริง
สถานะปลายทางคือ done, failed, expired หรือ needs_credit; สถานะหลังสุดเติมเครดิตแล้วเรียก POST /api/meeting/jobs/{jobId}/resume

4. กติกา

เครดิตหักก่อนเริ่มงาน — งานล้มเหลว/timeout คืนเครดิตอัตโนมัติ ไม่เสียฟรี
idempotency_key เดิม = ไม่หักซ้ำ (ได้งานเดิมกลับมา) — n8n retry ปลอดภัย
rate limit: 20 requests / 10 วินาที ต่อบัญชี (เกิน = HTTP 429)
เครดิตไม่พอ = HTTP 402 → เติมเครดิต
key หลุด → revoke ได้ทันทีที่หน้า API ของฉัน (สูงสุด 5 key ต่อบัญชี)

5. ตัวอย่าง n8n

HTTP Request node เดียว:

Method POST · URL https://aiwork.furredco.com/api/v1/run
Header Authorization = Bearer aiwork_live_xxxxx
Body (JSON): { "action": "caption", "input": { "brief": "{{ $json.product }}" }, "idempotency_key": "{{ $execution.id }}" }

งานภาพ: ต่อด้วย Wait 5s → HTTP GET /api/v1/task วน loop จน status != "processing"

workflow สรุปประชุมแบบเต็ม (Google Drive → upload → create job → poll → LINE + email) อยู่ในแพ็ค สรุปประชุมอัตโนมัติ

สร้าง API key →