מדריך למפתחים: הוספת יצירת וידאו בינה מלאכותית לאפליקציית המובייל שלך

כיצד להוסיף יצירת וידאו בינה מלאכותית לאפליקציה הניידת שלך: מדריך למפתח

תארו לעצמכם: משתמש לוחץ על 'צור וידאו' ומקבל קליפ מוכן באפליקציה תוך דקה. אבל במציאות, מודלים כמו Runway Gen-3, Sora, Kling דורשים GPUs חזקים (A100/H100) ולוקחים 30 שניות עד מספר דקות. המשימה של מפתח המובייל היא להגדיר זרימה אסינכרונית כך שהמשתמש לא יעזוב בזמן ההמתנה. אנו משלבים את ה-APIs האלה באפליקציות iOS/Android שלך, ומבטיחים יצירה אמינה, שמירה במטמון והתראות.

כיצד לשלב את Runway API באפליקציה ניידת?

Runway מספקת REST API עם סבב בדיקות לבדיקת סטטוס. ב-iOS, יישמנו שירות עם async/await ופס התקדמות המדמה ביצוע בהתבסס על זמן יצירה טיפוסי. ב-Android, אנו משתמשים ב-WorkManager עם CoroutineWorker—המשימה רצה ברקע גם כשהאפליקציה ממוזערת. הנה דוגמה לשירות iOS:

class VideoGenerationService {
    func generate(prompt: String, sourceImage: UIImage?) async throws -> URL {
        let taskId = try await runwayClient.createTask(
            prompt: prompt,
            imageURL: sourceImage.map { try await uploadImage($0) },
            duration: 5,
            ratio: "1280:768"
        )
        UserDefaults.standard.set(taskId, forKey: "pendingVideoTaskId")
        return try await pollWithBackoff(taskId: taskId)
    }

    private func pollWithBackoff(taskId: String) async throws -> URL {
        let intervals: [TimeInterval] = [3, 5, 8, 10, 10, 15, 15, 20, 20, 30]
        for interval in intervals + Array(repeating: 30.0, count: 10) {
            try await Task.sleep(nanoseconds: UInt64(interval * 1e9))
            let task = try await runwayClient.getTask(id: taskId)
            switch task.status {
            case .succeeded:
                UserDefaults.standard.removeObject(forKey: "pendingVideoTaskId")
                return task.output.first!
            case .failed:
                throw VideoGenError.generationFailed(task.failure ?? "Unknown")
            default:
                continue
            }
        }
        throw VideoGenError.timeout
    }
}

ב-Android: class VideoGenerationService { func generate(prompt: String, sourceImage: UIImage?) async throws -> URL { let taskId = try await runwayClient.createTask( prompt: prompt, imageURL: sourceImage.map { try await uploadImage($0) }, duration: 5, ratio: "1280:768" ) UserDefaults.standard.set(taskId, forKey: "pendingVideoTaskId") return try await pollWithBackoff(taskId: taskId) } private func pollWithBackoff(taskId: String) async throws -> URL { let intervals: [TimeInterval] = [3, 5, 8, 10, 10, 15, 15, 20, 20, 30] for interval in intervals + Array(repeating: 30.0, count: 10) { try await Task.sleep(nanoseconds: UInt64(interval * 1e9)) let task = try await runwayClient.getTask(id: taskId) switch task.status { case .succeeded: UserDefaults.standard.removeObject(forKey: "pendingVideoTaskId") return task.output.first! case .failed: throw VideoGenError.generationFailed(task.failure ?? "Unknown") default: continue } } throw VideoGenError.timeout } } עם WorkManager הוא הבחירה הנכונה למשימות רקע ארוכות. סבב בדיקות ב-CoroutineWorker, doWork() על Result.retry(), PROCESSING על Result.success(outputData).

מה לעשות אם היצירה אורכת יותר מדקה?

התראה Push היא אפשרות חובה. השרת עוקב אחר סטטוס המשימה ושולח FCM/APNs בסיום. קישורים עמוקים (Universal Links / App Links) מובילים למסך התוצאה עם הפעלה אוטומטית. אם המשתמש מזער את האפליקציה, ההתקדמות נשמרת דרך SUCCEEDED ב-UserDefaults.

הערכת התקדמות אמיתית ללא נתוני API

רוב ה-APIs לא מחזירים אחוז—רק סטטוס pendingTaskId/PENDING/PROCESSING. אנו משתמשים בפס התקדמות מדומה: טיימר ל-55 שניות (95%), ואז ממתינים לתגובה בפועל. זה עדיף על ספינר ריק.

טבלת השוואת APIs ליצירת וידאו בינה מלאכותית

Runway API מהיר בערך פי 2 מ-Kling AI עבור קליפים טיפוסיים. כדי לבחור API, שקלו את זמן היצירה ואורך הקליפ. Runway API הוא הבוגר ביותר עם SDKs ל-TypeScript/Python. Sora מ-OpenAI זמין כרגע רק דרך תוכנית שותפים. עמידה ב-הנחיות סקירת App Store (סעיף 4.2) היא חובה לפרסום.

השוואת גישות ליצירה אסינכרונית

הבחירה בין סבב בדיקות ל-WebSocket תלויה בתדירות העדכונים ובקריטיות ההתקדמות. לתרחישים פשוטים, סבב בדיקות מספיק; למורכבים, WebSocket.