AI Media Gen

AI Media Generator adalah fitur komprehensif dan extensible yang memungkinkan pengguna untuk membuat gambar dan video yang dihasilkan AI menggunakan berbagai model AI dari berbagai provider. Fitur ini menyediakan antarmuka terpadu untuk menghasilkan konten media dengan prompt teks dan gambar referensi opsional, mendukung model yang disediakan sistem maupun model kustom dari penyedia layanan AI mana pun yang kompatibel.

Memahami Fitur AI Media Generator

Tujuan: AI Media Generator menyediakan aplikasi TechMaju dengan framework yang fleksibel untuk memanfaatkan berbagai model AI untuk membuat konten visual (gambar dan video). Fitur ini mendukung berbagai penyedia layanan AI melalui antarmuka terpadu, memungkinkan organisasi untuk memilih model terbaik sesuai kebutuhan spesifik mereka. Sistem ini menangani proses generasi sinkron (gambar) dan asinkron (video) dengan mulus.

Fungsi: Fitur ini memungkinkan pengguna untuk: - Menghasilkan gambar menggunakan model AI text-to-image (t2i) dari berbagai provider - Menghasilkan video menggunakan model AI text-to-video (t2v) atau image-to-video (i2v) - Mengunggah gambar referensi untuk generasi image-to-video - Mengonfigurasi dan menggunakan model AI kustom dari provider mana pun yang kompatibel - Melacak status dan riwayat generasi di semua provider model - Mengunduh file media yang dihasilkan - Memantau dan membatalkan tugas generasi video yang sedang berlangsung - Menjelajahi riwayat generasi dengan pratinjau dan metadata

Extensibility (Kemampuan Diperluas): Sistem dirancang untuk mendukung: - Model Sistem: Model yang telah dikonfigurasi sebelumnya dan siap digunakan - Model Kustom: Integrasi dengan provider AI mana pun melalui konfigurasi API kustom - Multiple Provider: Penggunaan simultan model dari berbagai layanan AI - Autentikasi Fleksibel: Dukungan untuk berbagai metode API key dan autentikasi

Role yang Diperlukan

Role berikut diperlukan untuk mengakses dan menggunakan AI Media Generator:

Role Tingkat Akses Deskripsi
TM AI Developer Akses Penuh Role utama untuk menggunakan fitur AI Media Generation
System Manager Akses Penuh Akses administratif ke semua operasi DocType

Catatan: Halaman "AI Media Generator" dapat diakses oleh role System Manager dan TM AI Developer.

DocType Terkait

1. TM AI Generated File

DocType ini menyimpan catatan semua file media yang dihasilkan (gambar dan video) terlepas dari provider AI mana yang digunakan.

Field TM AI Generated File

Field Tipe Deskripsi
file_name Data Identifier unik untuk file yang dihasilkan (dibuat otomatis, read-only)
file_url Data Path URL ke file media yang dihasilkan (hidden, read-only)
ai_model Link Referensi ke TM AI Model yang digunakan untuk generasi (read-only)
type Select Tipe media: "Image" atau "Video" (read-only)
status Select Status generasi: Queued, Running, Cancelled, Succeeded, Failed
prompt Text Prompt teks asli yang digunakan untuk generasi
parameters JSON Parameter generasi (resolution, guidance_scale, seed, reference images, pengaturan khusus provider, dll.)
videogenid Data ID tugas untuk pelacakan generasi video (khusus provider)
file_preview HTML Pratinjau visual dari media yang dihasilkan (ditampilkan dalam tampilan form)
error_message Small Text Detail error jika generasi gagal

Indikator Status

Status Warna Deskripsi
Queued Cyan Status awal untuk tugas generasi video yang menunggu untuk dimulai
Running Blue Generasi video sedang berlangsung
Cancelled Pink Tugas generasi dibatalkan oleh pengguna
Succeeded Green Generasi selesai dengan sukses
Failed Red Generasi gagal karena error

2. TM AI Model

DocType ini mendefinisikan model AI yang tersedia dari berbagai provider untuk berbagai tugas termasuk generasi media.

Field TM AI Model

Field Tipe Deskripsi
model_name Data Nama tampilan model (unik, wajib diisi)
model_id Data Identifier model dari provider (contoh: "seedream-3-0-t2i-250415" untuk BytePlus)
model_type Select Kategori model: LLM, Image Gen, Video Gen, VLM
model_input Select Tipe input: Text, Image, atau Text + Image
model_output Select Tipe output: Text, Image, atau Video
active Check Aktifkan/nonaktifkan model untuk digunakan
issystemmodel Check Penanda untuk model sistem yang telah dikonfigurasi sebelumnya (read-only)
custom_model Data ID model kustom untuk provider AI pihak ketiga
customapikey Password API key untuk model kustom (disimpan dengan aman)
customapibase_url Data API base URL untuk provider model kustom
application Link Referensi ke My Application

Opsi Konfigurasi Model

Sistem mendukung dua tipe konfigurasi model:

1. Model Sistem: - Model yang telah dikonfigurasi sebelumnya dari provider default (saat ini BytePlus dalam MVP) - Menggunakan field model_id untuk identifier model - Autentikasi ditangani melalui konfigurasi site - Ditandai dengan is_system_model = 1

2. Model Kustom: - Model dari provider AI pihak ketiga mana pun - Menggunakan custom_model untuk identifier model - Menggunakan custom_api_key untuk autentikasi - Menggunakan custom_api_base_url untuk endpoint API - Mendukung API yang kompatibel dengan OpenAI atau integrasi kustom

Matriks Dukungan Tipe Model

Tipe Model Konvensi Penamaan Persyaratan Input Kasus Penggunaan
Text-to-Image (t2i) Mengandung "t2i" dalam model ID Hanya teks Menghasilkan gambar dari prompt teks
Text-to-Video (t2v) Mengandung "t2v" dalam model ID Hanya teks Menghasilkan video dari prompt teks
Image-to-Video (i2v) Mengandung "i2v" dalam model ID Teks + Gambar (wajib) Menghasilkan video dari teks dan gambar referensi
Multimodal model_input = "Text + Image" Teks + Gambar (opsional) Menghasilkan dengan gambar referensi opsional

Catatan: Kemampuan yang tepat tergantung pada provider AI dan model spesifik yang digunakan.

Prosedur

1. Navigasi ke AI Media Generator

Path: Home > AI Workspace > AI Media Generator

Atau gunakan search bar: Ketik "AI Media Generator" dan pilih halaman tersebut.

2. Memahami Antarmuka

AI Media Generator memiliki layout split-pane:

  • Panel Kiri: Pratinjau hasil saat ini dan tabel riwayat generasi
  • Panel Kanan: Kontrol generasi dan opsi konfigurasi
  • Desain Responsif: Secara otomatis menyesuaikan dengan perangkat mobile (single column pada layar < 992px)
  • Dapat Diubah Ukurannya: Seret handle pembagi untuk menyesuaikan ukuran panel

3. Memilih Tipe Media

  1. Di bagian atas panel kanan, pilih tipe media:

    • Image: Untuk menghasilkan gambar statis (lebih cepat, biasanya sinkron)
    • Video: Untuk menghasilkan klip video (lebih lambat, biasanya asinkron dengan polling)

  2. Antarmuka akan diperbarui untuk menampilkan model dan opsi yang relevan untuk pilihan Anda.

4. Memilih Model AI

  1. Klik dropdown Model
  2. Pilih dari model aktif yang tersedia:
    • Untuk mode Image: Hanya model Image Gen (t2i) yang ditampilkan
    • Untuk mode Video: Hanya model Video Gen (t2v/i2v) yang ditampilkan
  3. Model dari berbagai provider dapat ditampilkan bersama
  4. Kemampuan model (misalnya frame rate, durasi) ditampilkan di bawah dropdown

Catatan: Model yang tersedia tergantung pada konfigurasi sistem Anda dan provider mana yang telah diatur oleh administrator Anda.

5. Menyediakan Input (Gambar Referensi)

Catatan: Persyaratan file input tergantung pada tipe model yang dipilih dan kemampuan provider.

Ketika File Input DIWAJIBKAN (model i2v):

  1. Pilih tab File Upload atau URL Input
  2. Untuk File Upload:
    • Klik Choose Files atau drag and drop
    • Format yang didukung: .jpg, .jpeg, .png
    • Maksimum: 3 file (dapat bervariasi menurut provider)
  3. Untuk URL Input:
    • Masukkan URL gambar dan klik Add
    • Ulangi untuk beberapa gambar (maks 3)
  4. Kartu pratinjau menampilkan gambar yang diunggah/ditambahkan
  5. Klik × pada kartu untuk menghapus gambar

Ketika File Input OPSIONAL (model Text + Image):

  • Ikuti langkah yang sama seperti di atas, tetapi gambar tidak wajib
  • Anda dapat melanjutkan hanya dengan prompt teks

Ketika File Input TERSEMBUNYI (model t2i/t2v):

  • Bagian input file tidak ditampilkan
  • Hanya prompt teks yang diperlukan

6. Menulis Prompt

  1. Di area teks Prompt, masukkan deskripsi detail dari media yang ingin Anda hasilkan
  2. Best practice:
    • Bersikaplah spesifik dan deskriptif
    • Sertakan detail tentang gaya, suasana, warna, komposisi
    • Untuk video: Jelaskan aksi atau gerakan
    • Contoh: "Matahari terbenam yang tenang di atas laut yang tenang dengan awan oranye dan pink yang cerah, gaya fotorealistik"

Catatan: Struktur prompt yang optimal dapat bervariasi menurut provider dan model AI. Konsultasikan dokumentasi model Anda untuk hasil terbaik.

7. Mengonfigurasi Parameter

Parameter yang tersedia tergantung pada model dan provider yang dipilih. Parameter umum meliputi:

Untuk Generasi Gambar:

  • Resolution: Pilih dari ukuran yang tersedia (bervariasi menurut provider)
  • Guidance Scale: Biasanya 1.0 hingga 10.0 (lebih tinggi = lebih mengikuti prompt)
  • Seed: -1 untuk random, atau angka spesifik untuk reproduktibilitas
  • Watermark: Aktifkan/nonaktifkan watermark pada gambar yang dihasilkan
  • Parameter Tambahan: Opsi khusus provider mungkin tersedia

Untuk Generasi Video:

  • Resolution: Pilih dari opsi yang tersedia (misalnya 480p, 720p, 1080p)
  • Aspect Ratio: Berbagai rasio tergantung dukungan provider
  • Duration: Durasi yang tersedia dalam detik
  • Frame Rate: Frame rate yang didukung (misalnya 24, 30 fps)
  • Seed: -1 untuk random, atau angka spesifik untuk reproduktibilitas
  • Watermark: Aktifkan/nonaktifkan watermark pada video yang dihasilkan
  • Parameter Tambahan: Opsi khusus provider mungkin tersedia

8. Menghasilkan Media

  1. Tinjau semua input: model, prompt, gambar referensi (jika berlaku), parameter
  2. Klik tombol Generate ✨
  3. Untuk Gambar (biasanya sinkron):
    • Animasi loading muncul (efek pulse border)
    • Generasi selesai berdasarkan kecepatan provider (biasanya 30-90 detik)
    • Gambar muncul di panel pratinjau kiri
    • Status: "Succeeded" saat selesai
  4. Untuk Video (biasanya asinkron):
    • Respons awal segera dengan task ID
    • Status dimulai sebagai "Queued"
    • Frontend melakukan polling status secara berkala
    • Status berkembang: Queued → Running → Succeeded
    • Video muncul di panel pratinjau saat selesai
    • Catatan: Waktu generasi video bervariasi menurut provider dan parameter

9. Melihat Hasil

  1. Panel Pratinjau:

    • Gambar ditampilkan sebagai <img> dengan resolusi penuh
    • Video ditampilkan dengan kontrol player HTML5 (play, pause, volume, fullscreen)

  2. Informasi Generasi:

    • Nama model dan parameter ditampilkan di bawah pratinjau
    • Teks prompt ditampilkan
    • Resolusi dan timestamp generasi

10. Mengunduh Media yang Dihasilkan

  1. Klik tombol Download di bawah pratinjau
  2. File disimpan dengan format nama file yang cerdas:
    • Pola: {model_name}_{YYYYMMDD_HHMMSS}_{hash}.{ext}
    • Contoh: image_model_20260112_143022_abc12345.png
  3. File juga disimpan di Frappe File Manager:
    • Gambar: "AI Generated Images/YYYY-MM/"
    • Video: "AI Generated Videos/YYYY-MM/"

11. Menjelajahi Riwayat Generasi

  1. Tabel History menampilkan 20 generasi terakhir di semua model dan provider
  2. Kolom yang ditampilkan:
    • Preview: Thumbnail media yang dihasilkan
    • Model: Model AI yang digunakan
    • Prompt: 50 karakter pertama dari prompt
    • Resolution: Ukuran atau aspect ratio
    • Status: Status generasi saat ini
    • Created: Timestamp generasi
  3. Klik baris apa pun untuk memuat ulang hasil tersebut ke panel pratinjau
  4. Klik header kolom untuk mengurutkan tabel

12. Membatalkan Generasi Video

Hanya untuk tugas video yang sedang berlangsung (memerlukan dukungan provider):

  1. Saat status "Queued" atau "Running":
    • Tombol Cancel muncul di panel pratinjau
    • Atau buka dokumen TM AI Generated File dan klik Cancel
  2. Klik Cancel untuk menghentikan generasi
  3. Status berubah menjadi "Cancelled"
  4. Tidak ada polling lebih lanjut yang terjadi

Catatan: Dukungan pembatalan tergantung pada kemampuan API provider AI.

13. Mengakses DocType TM AI Generated File (Lanjutan)

Untuk tujuan administratif atau pelacakan detail:

  1. Navigasi ke: Home > TechMaju AI > TM AI Generated File
  2. Lihat semua file yang dihasilkan dengan metadata lengkap
  3. Setiap dokumen menampilkan:
    • Pratinjau file (gambar atau video tertanam)
    • Semua parameter generasi dalam format JSON
    • Pelacakan status
    • Pesan error (jika gagal)
    • ID tugas khusus provider (untuk video)

Mengonfigurasi Model AI (Administrator)

Menambahkan Model Sistem

Untuk model provider yang telah dikonfigurasi sebelumnya (saat ini BytePlus):

  1. Navigasi ke: Home > TechMaju AI > TM AI Model
  2. Klik + Add TM AI Model
  3. Isi field:
    • Model Name: Nama tampilan (contoh: "SeeDream 3.0 Image Generator")
    • Model ID: Identifier model dari provider
    • Model Type: Pilih "Image Gen" atau "Video Gen"
    • Model Input: Pilih persyaratan tipe input
    • Model Output: Pilih "Image" atau "Video"
    • Active: Centang untuk mengaktifkan
    • Is System Model: Centang untuk model sistem
  4. Simpan dokumen

Catatan: Model sistem menggunakan kredensial API yang dikonfigurasi dalam konfigurasi site.

Menambahkan Model Kustom

Untuk provider AI pihak ketiga:

  1. Navigasi ke: Home > TechMaju AI > TM AI Model
  2. Klik + Add TM AI Model
  3. Isi field:
    • Model Name: Nama tampilan (contoh: "OpenAI DALL-E 3")
    • Model Type: Pilih "Image Gen" atau "Video Gen"
    • Model Input: Pilih persyaratan tipe input
    • Model Output: Pilih "Image" atau "Video"
    • Active: Centang untuk mengaktifkan
    • Custom Model: Identifier model dari provider
    • Custom API Key: API key Anda untuk provider
    • Custom API Base URL: Endpoint API provider
  4. Simpan dokumen

Provider Kustom yang Didukung: - API yang kompatibel dengan OpenAI (DALL-E, Stable Diffusion, dll.) - Provider mana pun dengan REST API yang kompatibel - Model AI in-house kustom

Persyaratan untuk Model Kustom: - API harus mendukung generasi text-to-image atau text-to-video - Format respons harus kompatibel (URL atau base64) - Autentikasi melalui API key dalam header

Arsitektur & Detail Teknis

Struktur Penyimpanan File

Private Files/
├── AI Generated Images/
│   ├── 2026-01/
│   │   ├── model_20260112_143022_abc12345.png
│   │   └── ...
│   └── 2026-02/
└── AI Generated Videos/
    ├── 2026-01/
    │   ├── model_20260112_150030_xyz67890.mp4
    │   └── ...
    └── 2026-02/

API Endpoint

Endpoint Metode Tujuan
techmaju_ai.api.ai_media_gen.get_media_models GET Mengambil model Image Gen dan Video Gen yang tersedia dari semua provider
techmaju_ai.api.ai_media_gen.generate_media POST Memulai generasi gambar atau video menggunakan model yang ditentukan
techmaju_ai.api.ai_media_gen.get_generation_history GET Mengambil catatan generasi terkini di semua model
techmaju_ai.api.ai_media_gen.check_video_status GET Polling status tugas video (khusus provider)
techmaju_ai.api.ai_media_gen.cancel_video_generation POST Membatalkan tugas video yang sedang berlangsung (khusus provider)

Arsitektur Integrasi Provider

Sistem menggunakan lapisan integrasi yang fleksibel yang mendukung berbagai provider AI:

Implementasi Saat Ini (MVP): - Provider Default: BytePlus Ark API (Asia Pacific) - Base URL: https://ark.ap-southeast.bytepluses.com/api/v3 - Autentikasi: Bearer token dari konfigurasi site

Extensibility: - Dukungan Provider Kustom: Melalui customapibaseurl dan customapi_key - Multiple Provider: Dapat menggunakan berbagai provider secara bersamaan - Antarmuka Provider-Agnostic: Pengalaman pengguna terpadu terlepas dari provider backend

Alur Generasi Gambar: 1. Pengguna memilih model (sistem atau kustom) 2. Sistem mengarahkan ke API provider yang sesuai 3. Pemrosesan sinkron atau asinkron berdasarkan provider 4. File diunduh dan disimpan di penyimpanan terpadu 5. Metadata disimpan di TM AI Generated File

Alur Generasi Video: 1. Pengguna memilih model (sistem atau kustom) 2. Sistem mengarahkan ke API provider yang sesuai 3. Tugas asinkron dimulai dengan task ID khusus provider 4. Polling status melalui endpoint status provider 5. Video diunduh saat siap 6. Metadata disimpan dengan informasi pelacakan tugas

Fitur Keamanan

  • Kontrol Akses Berbasis Role: Semua endpoint memerlukan role TM AI Developer
  • Penyimpanan Kredensial Aman: API key dienkripsi dalam database
  • URL Bertanda: File yang dihasilkan menggunakan signed URL dengan batas waktu untuk akses yang aman
  • Validasi Parameter: Semua input disanitasi dan divalidasi sebelum panggilan API
  • Pembatasan Tipe File: Hanya tipe file yang aman yang diterima untuk upload
  • Rate Limiting: Dikontrol oleh kuota provider individual

Best Practice

Untuk Hasil Optimal

  1. Prompt Engineering:

    • Bersikaplah deskriptif dan spesifik tentang output yang diinginkan
    • Sertakan deskriptor gaya yang sesuai untuk model
    • Tentukan komposisi, pencahayaan, warna, dan suasana
    • Untuk video: Jelaskan aksi atau gerakan kamera
    • Catatan: Model AI yang berbeda mungkin menginterpretasikan prompt secara berbeda - eksperimen dengan gaya prompt

  2. Pemilihan Model:

    • Pilih model berdasarkan kasus penggunaan dan persyaratan kualitas Anda
    • Model sistem telah dikonfigurasi sebelumnya dan lebih mudah digunakan
    • Model kustom menawarkan fleksibilitas dan pilihan provider
    • Pertimbangkan trade-off biaya, kecepatan, dan kualitas
    • Uji beberapa model untuk menemukan yang paling sesuai dengan kebutuhan Anda

  3. Gambar Referensi (untuk model i2v):

    • Gunakan gambar berkualitas tinggi (minimum 720p direkomendasikan)
    • Pastikan gambar jelas dan terang
    • Hindari konten berhak cipta atau sensitif
    • Jumlah maksimum gambar tergantung provider (biasanya 3)

  4. Penyetelan Parameter:

    • Mulai dengan nilai default atau yang direkomendasikan
    • Guidance scale lebih tinggi biasanya = lebih mengikuti prompt tetapi kurang kreatif
    • Gunakan seed spesifik untuk mereproduksi hasil
    • Pilih resolusi berdasarkan kasus penggunaan (lebih tinggi = kualitas lebih baik tetapi lebih lambat/lebih mahal)
    • Catatan: Efek parameter bervariasi menurut model dan provider

  5. Generasi Video:

    • Harapkan waktu tunggu yang bervariasi tergantung provider dan parameter
    • Pantau status di tabel riwayat
    • Pertimbangkan untuk membiarkan tab terbuka selama generasi untuk pembaruan real-time
    • Batalkan tugas yang memakan waktu lebih lama dari yang diharapkan

Untuk Administrasi Sistem

  1. Manajemen Model:

    • Tinjau dan perbarui model yang tersedia secara berkala
    • Uji model baru di lingkungan development sebelum produksi
    • Nonaktifkan model yang usang, lambat, atau mahal
    • Pantau model mana yang paling populer di kalangan pengguna
    • Pertimbangkan biaya per generasi saat menambahkan model

  2. Konfigurasi Provider:

    • Untuk model sistem: Konfigurasi API key provider dalam konfigurasi site
    • Untuk model kustom: Simpan API key dengan aman di dokumen TM AI Model
    • Rotasi API key secara berkala untuk keamanan
    • Pantau kuota dan penggunaan API di semua provider
    • Siapkan alert untuk batas kuota atau kegagalan API

  3. Manajemen Penyimpanan:

    • Pantau folder "AI Generated Images" dan "AI Generated Videos" untuk penggunaan disk
    • Terapkan kebijakan pembersihan untuk file lama (misalnya arsip setelah 90 hari)
    • Pertimbangkan penyimpanan eksternal atau CDN untuk menyajikan file media
    • Backup generasi penting sebelum pembersihan

  4. Pemantauan Penggunaan:

    • Tinjau TM AI Usage Log secara berkala untuk pelacakan biaya di semua provider
    • Analisis model dan provider mana yang paling cost-effective
    • Siapkan alert untuk penggunaan tinggi atau error
    • Pantau generasi yang gagal untuk mengidentifikasi model atau prompt yang bermasalah

  5. Optimasi Performa:

    • Cache prompt yang sering dihasilkan jika berlaku
    • Terapkan manajemen antrian untuk periode traffic tinggi
    • Gunakan CDN untuk menyajikan file media yang dihasilkan
    • Pertimbangkan load balancing di berbagai provider
    • Pantau waktu respons menurut provider dan model

  6. Keamanan:

    • Rotasi semua API key provider secara berkala
    • Audit generasi pengguna untuk konten yang tidak pantas
    • Pastikan kedaluwarsa signed URL sesuai untuk kasus penggunaan Anda
    • Batasi role TM AI Developer hanya untuk pengguna terpercaya
    • Tinjau konfigurasi model kustom untuk kepatuhan keamanan

Untuk Pengembangan

  1. Pengujian:

    • Uji dengan API key non-produksi dalam development
    • Validasi semua tipe model sebelum deploy ke produksi
    • Uji skenario error (kegagalan API, parameter tidak valid, kuota terlampaui)
    • Verifikasi logika polling untuk provider asinkron
    • Uji integrasi provider kustom secara menyeluruh

  2. Menambahkan Provider Baru:

    • Dokumentasikan persyaratan API khusus provider
    • Terapkan pola adapter untuk logika khusus provider
    • Uji alur generasi sinkron dan asinkron
    • Verifikasi penanganan error dan pemetaan status
    • Perbarui dokumentasi dengan kemampuan khusus provider

  3. Model Kustom:

    • Gunakan field custommodel, customapikey, dan customapibaseurl
    • Pastikan provider kustom mengikuti kontrak API yang kompatibel
    • Dokumentasikan persyaratan parameter khusus provider
    • Terapkan penanganan error yang tepat untuk error khusus provider
    • Uji alur autentikasi dan otorisasi

  4. Integrasi:

    • Gunakan API endpoint yang diekspos untuk berintegrasi dengan DocType lain
    • Pertimbangkan untuk menyematkan fungsi generasi dalam alur kerja
    • Manfaatkan riwayat generasi untuk analitik dan pelaporan
    • Bangun di atas sistem manajemen model yang extensible

Troubleshooting

Masalah Umum

Masalah Kemungkinan Penyebab Solusi
"No models available" Tidak ada model Image Gen atau Video Gen yang aktif dikonfigurasi Aktifkan model di DocType TM AI Model
"Reference images required" Menggunakan model i2v tanpa gambar Unggah setidaknya satu gambar referensi
"Generation failed" Error API, kuota terlampaui, parameter tidak valid, masalah provider Periksa field error_message, verifikasi kredensial API dan kuota
"Video stuck in Queued" Penundaan atau kegagalan API provider Tunggu, lalu periksa status layanan provider
"Download not working" URL file kedaluwarsa atau generasi belum selesai Hasilkan ulang media atau periksa field file_url
"Permission denied" Pengguna tidak memiliki role TM AI Developer Tetapkan role TM AI Developer ke pengguna
"Model not responding" Model kustom salah dikonfigurasi atau provider down Verifikasi customapibaseurl dan customapi_key, periksa status provider
"Authentication failed" API key tidak valid atau kedaluwarsa Perbarui API key dalam konfigurasi model atau site config

Masalah Khusus Provider

Untuk Model Sistem: - Verifikasi konfigurasi site memiliki API key provider yang benar - Periksa status layanan dan kuota provider - Tinjau dokumentasi API provider untuk perubahan

Untuk Model Kustom: - Verifikasi customapibaseurl benar dan dapat diakses - Periksa customapikey valid dan memiliki kuota yang cukup - Pastikan ID model kustom cocok dengan identifier model provider - Tinjau pesan error khusus provider di field errormessage

Mendapatkan Bantuan

  • Periksa pesan error generasi di dokumen TM AI Generated File
  • Tinjau log server: bench --site [site-name] console → Periksa frappe.log
  • Verifikasi status dan kuota API provider
  • Untuk model kustom: Uji kredensial API secara independen
  • Periksa dokumentasi khusus provider untuk persyaratan parameter
  • Hubungi dukungan provider untuk masalah khusus API
Discard
Save
Draft

Previous Page

Left

Next Page

Right

On this page

Review Changes ← Back to Content
Message Status Space Raised By Last update on