API rendering AI Graydient
Jika kamu membuat aplikasi, alat internal, atau pipeline render, Graydient menyediakan model gambar, video, dan LLM terbuka di GPU khusus, lewat satu API, dengan harga bulanan flat.
Paket mana yang menyertakannya
API pribadi hanya tersedia dengan Video Max. Images dan Video Plus tidak termasuk akses API. Kamu bisa upgrade, downgrade atau batalkan kapan saja di portal penagihan, dengan biaya prorata. Harga paket Business dan API ada di business.graydient.ai.
API pribadi adalah kunci untuk satu pengguna manusia, dan lalu lintas otomatis tidak diperbolehkan di paket pribadi mana pun. Artinya tidak ada bot, skrip, penjadwal, pekerjaan batch, scraper, aplikasi multi-pengguna atau akses yang dijual kembali. Dibatasi: sekitar satu panggilan setiap 10 detik. Kunci yang mengirim lalu lintas otomatis atau berlebihan dicabut tanpa pemberitahuan.
Membangun produk multi-pengguna atau white-label
Pengguna virtual dan login white-label adalah fitur tingkat bisnis untuk aplikasi yang sudah dipakai banyak pengguna. Mereka bekerja di API pribadi, jadi kamu bisa membangun dan menguji alur multi-pengguna dan white-label di Video Max selama pengembangan.
Untuk live dengan produk multi-pengguna, lalu lintas otomatis atau akses yang dijual kembali perlu paket Business: server GPU khusus. business.graydient.ai menjelaskan apa saja yang termasuk, daftar harga dan penjualannya.
| API Pribadi (Video Max) | Deployment Bisnis | |
|---|---|---|
| Pengguna | Satu pengguna (kamu) | Pengguna produkmu |
| Penjualan kembali | Tidak diperbolehkan | Diperbolehkan |
| Pengguna virtual dan login label putih | Bangun dan uji | Mulai langsung |
| Cara mendapatkannya | Berlangganan Video Max | Server GPU khusus atau perjanjian bisnis |
Cara kerja API
Versi saat ini adalah V3, di https://cloud.graydient.ai/api/v3/. Ini mengikuti spesifikasi JSON:API: kirim dan terima application/vnd.api+json, autentikasi dengan token HTTP Bearer standar dari halaman token API-mu, dan baca hasil dari objek data dengan anggota attributes.
Rendering bersifat asinkron. Kamu POST ke POST /api/v3/render/ dengan prompt dan callback_url yang wajib. Graydient langsung membalas dengan render_hash plus perkiraan waktu tunggu dan render. Saat pekerjaan selesai, hasilnya POST ke webhook-mu. Field opsional termasuk:
- error_url: webhook untuk kegagalan
- init_image dan mask_image: untuk image-to-image dan inpainting
- placeholders: URL gambar bernama untuk mode ControlNet atau adaptor IP
- progressive_return: satu callback per gambar
- session_id: mengaitkan render dengan pengguna milikmu
Workflow dijalankan lewat endpoint yang sama dengan perintah workflow di prompt.
Status tanpa polling: GET GET /api/v3/render/{render_hash} mengembalikan status render, tapi dokumen menyarankan jangan polling. Gunakan webhook, atau stream WebSocket di wss://cloud.graydient.ai/render-events/{render_hash}, yang mengirim event started, image_done, done dan error.
Keluarga endpoint lain
- Chat: chat LLM dengan persona. Balasan dikirim ke callback atau kembali langsung dengan sync: true, dan model vision menerima image_url.
- Concepts: daftar model dan LoRA yang tersedia.
- Workflows: daftar workflow dan apa yang didukung, seperti txt2img, img2img, txt2vid dan img2vid.
- Knowledge base: buat domain, tambah fakta, crawl URL, lalu cari atau chat.
- Skills: ubah permintaan bahasa alami jadi perintah workflow.
- Virtual users: petakan pengguna akhir ke catatan di akunmu. Bangun dan uji dengan API personal, lalu mulai langsung di deployment bisnis.
Referensi lengkap: dokumentasi API. Dokumen menyatakan masih dalam pengembangan.
Kasus penggunaan umum
- Menjalankan aplikasi sendiri: gunakan Graydient sebagai backend render untuk fitur gambar, video atau chat. Kembangkan di API personal, lalu pindah ke deployment bisnis saat pengguna nyata datang.
- Menggunakan model yang kamu hosting: render dengan LoRA dan checkpoint yang sudah kamu pasang. Lihat hosting model AI sendiri.
- Menjalankan workflow gaya ComfyAPI secara remote: panggil workflow yang dipetakan dari kode kamu sendiri.
- Gambar produk dan katalog: upscale, edit atau ubah gaya gambar dari pipeline, dalam batas rate API personal.
- Batch rendering: untuk batch besar dan berkelanjutan, gunakan server GPU khusus daripada API personal.
- Chat basis pengetahuan: buat asisten dukungan atau dokumentasi di endpoint knowledge base dan chat.
Server GPU khusus
Jika kamu berencana menjalankan lalu lintas otomatis, produk multi-pengguna, akses API yang dijual kembali atau rendering batch sepanjang hari, kamu perlu paket Business: server GPU khusus, dengan mesin sendiri dan tanpa antrean bersama. Harga, apa saja yang termasuk dan formulir pemesanan ada di business.graydient.ai.
Harga per-render untuk server khusus, termasuk video, tercantum di business.graydient.ai. Harga per-render ini hanya berlaku untuk paket Business. Images, Video Plus dan Video Max tetap tarif tetap tanpa biaya per-render.
Lalu lintas otomatis tidak diperbolehkan di paket pribadi. Images, Video Plus dan Video Max adalah paket tarif tetap untuk satu pengguna manusia, dan kunci yang mengirim lalu lintas otomatis dicabut.
Memulai
- Berlangganan Video Max. Kamu bisa ubah atau batalkan paket kapan saja di portal penagihan.
- Buat token di halaman token API-mu.
- Baca dokumentasi API dan cari contoh penggunaan Graydient API di GitHub.
- Siapkan endpoint webhook, lalu kirim permintaan render pertamamu.
- Mirror dan buat thumbnail gambar hasil sebelum disajikan ke pengguna, seperti yang disarankan dokumen.
Dukungan API tersedia lewat email di info@graydient.ai. Semua penggunaan tunduk pada kebijakan penggunaan yang dapat diterima dan ketentuan penggunaan.