เริ่มต้นอย่างรวดเร็ว

คู่มือนี้จะพาคุณจากคีย์ API ไปสู่ MP4 ที่เสร็จสมบูรณ์บนดิสก์คุณต้องมีบัญชีในแผน Agency และมีเวลาสักครู่ในระหว่างการเรนเดอร์วิดีโอ

คำเตือน

ขั้นตอนที่ 3 เริ่มเรนเดอร์จริงและใช้เครดิตในบัญชีของคุณ

1. รับกุญแจAPI

   ในแอป เปิด Account > API keys, สร้าง key แล้วก็อปปี้มันจากนั้นเก็บไว้ในตัวแปรสภาพแวดล้อมเพื่อไม่ให้มันอยู่ในโค้ดของคุณ:

   export REIGNITER_API_KEY="emp_..."

   ดูรายละเอียดเพิ่มเติมได้ที่ การตรวจสอบสิทธิ์

2. ตรวจสอบกุญแจ

   โทรหา GET /v1/me``200 หมายความว่ากุญแจใช้ได้คําตอบจะแสดงยอดเครดิตของคุณด้วย

   curl

   curl https://reigniter.ai/v1/me \
     -H "Authorization: Bearer $REIGNITER_API_KEY"

   JavaScript

   const BASE = 'https://reigniter.ai';
   const headers = { Authorization: `Bearer ${process.env.REIGNITER_API_KEY}` };
   
   const res = await fetch(`${BASE}/v1/me`, { headers });
   console.log(res.status, await res.json());

   Python

   import os, requests
   
   BASE = "https://reigniter.ai"
   headers = {"Authorization": f"Bearer {os.environ['REIGNITER_API_KEY']}"}
   
   res = requests.get(f"{BASE}/v1/me", headers=headers)
   print(res.status_code, res.json())

   {
     "user_id": "3f1c2a9e-8b7d-4c1e-9f0a-2d6b5e4c3a21",
     "email": "dev@example.com",
     "name": "Sam",
     "credits_remaining": 42
   }

3. เริ่มวิดีโอ

   โทรหา POST /v1/renderด้วย brief Reigniter วางแผนฉากและเริ่มเรนเดอร์ส่ง Idempotency-Keyที่มีค่าใหม่ เพื่อให้การลองใหม่ของเครือข่ายไม่สามารถเริ่มวิดีโอเดิมซ้ําได้

   curl

   curl https://reigniter.ai/v1/render \
     -H "Authorization: Bearer $REIGNITER_API_KEY" \
     -H "Content-Type: application/json" \
     -H "Idempotency-Key: $(uuidgen)" \
     -d '{
       "brief": "A 20 second advert for Northwind Coffee, a small-batch roaster. Warm, early-morning mood. End on the line: Roasted this week, at your door by Friday.",
       "kind": "ad",
       "duration_sec": 20,
       "aspect": "9:16",
       "quality": "draft"
     }'

   JavaScript

   import { randomUUID } from 'node:crypto';
   
   const res = await fetch(`${BASE}/v1/render`, {
     method: 'POST',
     headers: {
       ...headers,
       'Content-Type': 'application/json',
       'Idempotency-Key': randomUUID(),
     },
     body: JSON.stringify({
       brief: 'A 20 second advert for Northwind Coffee, a small-batch roaster. Warm, early-morning mood. End on the line: Roasted this week, at your door by Friday.',
       kind: 'ad',
       duration_sec: 20,
       aspect: '9:16',
       quality: 'draft',
     }),
   });
   const job = await res.json();
   if (res.status !== 202) throw new Error(`${res.status} ${job.code}: ${job.error}`);
   console.log(job.job_id);

   Python

   import uuid
   
   res = requests.post(
       f"{BASE}/v1/render",
       headers={**headers, "Idempotency-Key": str(uuid.uuid4())},
       json={
           "brief": "A 20 second advert for Northwind Coffee, a small-batch roaster. "
                    "Warm, early-morning mood. End on the line: "
                    "Roasted this week, at your door by Friday.",
           "kind": "ad",
           "duration_sec": 20,
           "aspect": "9:16",
           "quality": "draft",
       },
   )
   job = res.json()
   if res.status_code != 202:
       raise RuntimeError(f"{res.status_code} {job.get('code')}: {job['error']}")
   print(job["job_id"])

   คุณจะได้ 202 Accepted และ job_id:

   {
     "job_id": "7d2e4b10-5c3a-4f8e-a1b2-9c0d8e7f6a54",
     "status": "starting",
     "title": "Northwind Coffee, at your door by Friday",
     "scenes": 4,
     "credits_used": 12,
     "watermarked": false,
     "poll_url": "/v1/job/7d2e4b10-5c3a-4f8e-a1b2-9c0d8e7f6a54",
     "note": "Render started. Poll poll_url, or subscribe to video.completed via POST /api/webhooks/hooks."
   }

   หมายเหตุ

   วิดีโอนี้ไม่มีแบรนด์ เพราะการเรนเดอร์API ไม่เคยมีแบรนด์ด้วยตัวเองหากต้องการสร้างแบรนด์ ให้เพิ่ม brand_logo_urlดูที่ การสร้างวิดีโอ

4. รอให้งานเสร็จ

   โพล GET /v1/job/{id} ทุกไม่กี่วินาทีจนกว่า status จะ succeeded, failed หรือ cancelled การเรนเดอร์มักใช้เวลาหลายนาที

   curl

   JOB_ID="7d2e4b10-5c3a-4f8e-a1b2-9c0d8e7f6a54"
   
   while true; do
     JOB=$(curl -s "https://reigniter.ai/v1/job/$JOB_ID" \
       -H "Authorization: Bearer $REIGNITER_API_KEY")
     STATUS=$(echo "$JOB" | jq -r .status)
     echo "$STATUS $(echo "$JOB" | jq -r .progress)%"
     case "$STATUS" in succeeded|failed|cancelled) break ;; esac
     sleep 10
   done
   echo "$JOB"

   JavaScript

   const FINAL = new Set(['succeeded', 'failed', 'cancelled']);
   
   let result;
   while (true) {
     const res = await fetch(`${BASE}/v1/job/${job.job_id}`, { headers });
     result = await res.json();
     console.log(result.status, `${result.progress}%`);
     if (FINAL.has(result.status)) break;
     await new Promise((r) => setTimeout(r, 10_000));
   }
   if (result.status !== 'succeeded') throw new Error(result.error ?? result.status);

   Python

   import time
   
   FINAL = {"succeeded", "failed", "cancelled"}
   
   while True:
       result = requests.get(f"{BASE}/v1/job/{job['job_id']}", headers=headers).json()
       print(result["status"], f"{result['progress']}%")
       if result["status"] in FINAL:
           break
       time.sleep(10)
   
   if result["status"] != "succeeded":
       raise RuntimeError(result["error"] or result["status"])

   งานที่เสร็จแล้วจะมีลักษณะดังนี้:

   {
     "job_id": "7d2e4b10-5c3a-4f8e-a1b2-9c0d8e7f6a54",
     "status": "succeeded",
     "progress": 100,
     "video_url": "https://cdn.example.com/exports/7d2e4b10.mp4",
     "error": null
   }

   แทนที่จะสํารวจความคิดเห็น คุณสามารถสมัคร webhook เพื่อ video.completed

5. ดาวน์โหลดวิดีโอ

   video_url มีลิงก์ตรงไปยัง MP4ดาวน์โหลดและเก็บไว้ที่ฝั่งของคุณ

   curl

   curl -L -o northwind.mp4 "$(echo "$JOB" | jq -r .video_url)"

   JavaScript

   import { writeFile } from 'node:fs/promises';
   
   const video = await fetch(result.video_url);
   await writeFile('northwind.mp4', Buffer.from(await video.arrayBuffer()));

   Python

   video = requests.get(result["video_url"])
   video.raise_for_status()
   with open("northwind.mp4", "wb") as f:
       f.write(video.content)

ถ้าเกิดปัญหา

• 401: ตรวจสอบคีย์และคํานําหน้า Bearer ดูที่ การตรวจสอบสิทธิ์
• 402: บัญชีไม่ได้อยู่ในแผน Agency หรือเครดิตหมดแล้วอ่าน code
• 422 BRAND_REQUIRED หรือ NO_ANCHOR หรือ 400 PRESENTER_REQUIRED: การเรนเดอร์ต้องการแบรนด์ รูปภาพสินค้า หรือผู้นําเสนอดูที่ การสร้างวิดีโอ
• 429: ช้าลงหน่อยดูที่ Limits

ทุกสถานะและ code จะแสดงใน Errors

ขั้นตอนถัดไป

• การทําวิดีโอ: ชุดแบรนด์ รูปภาพสินค้า แผนฉาก และวิดีโอฝึกอบรม
• Webhooks: รับการเรียกกลับที่เซ็นชื่อเมื่อวิดีโอพร้อม
• สร้างการอ้างอิงเรนเดอร์: ทุกฟิลด์