Cipta melalui
aplikasi anda.

Penggunaan komersial dan pelesenan API

Bina SaaS berbayar atau aplikasi anda sendiri menggunakan integrasi backend peribadi anda. Anda boleh mengenakan bayaran untuk aplikasi dan hasil yang dijana. Penjualan kunci API, akses API mentah atau gerbang API laluan adalah dilarang. Baca dan terima Terma API apabila mencipta kunci.

1. Sediakan akaun anda

Log masuk, lengkapkan sebarang perubahan kata laluan yang diperlukan, beli pek kredit apabila pembayaran dibuka, dan cipta kunci dalam Tetapan → Kunci API Pembangun. Simpan kunci pada pelayan anda dan hantar Authorization: Bearer YOUR_STUDIO_API_KEY. Jangan sekali-kali meletakkan kunci dalam kod bahagian hadapan.

2. Pilih dan sebut harga

GET /api/v1/models menyenaraikan ID model yang tersedia, format asli, resolusi dan tempoh. POST /api/v1/quote mengembalikan kredit yang diperlukan dan nilai nominal RM yang setara. Harga pek sebenar bagi setiap kredit berbeza. Gunakan tetapan yang sama semasa menghantar.

GET /api/v1/balance mengembalikan kredit prabayar anda yang tersedia.

3. Hantar satu generasi

POST /api/v1/generations menerima badan JSON dengan model, format, resolusi, prompt dan duration_seconds untuk video. Sertakan yang unik Idempotency-Key header, 8–100 huruf, digit, garis bawah atau sengkang. Cuba semula permintaan yang tidak pasti dengan kunci yang sama dan badan yang tidak berubah untuk mengelakkan penyerahan pendua.

{
  "model": "MODEL_ID_FROM_MODELS_ENDPOINT",
  "format": "FORMAT_VALUE_FROM_MODELS_ENDPOINT",
  "resolution": "RESOLUTION_FROM_MODELS_ENDPOINT",
  "prompt": "A premium product photograph with warm studio lighting"
}

4. Jejaki dan muat turun

Tinjauan GET /api/v1/generations/JOB_ID. Apabila selesai, muat turun GET /api/v1/generations/JOB_ID/asset menggunakan kunci Bearer yang sama. URL aset memerlukan pengesahan; muat turunnya di bahagian belakang anda sebelum menyediakannya kepada pelanggan.

Had dan bil

Petikan tidak menempah kredit. Penyerahan menyemak harga semasa, akses akaun, baki prabayar dan belanjawan perkhidmatan. Penyerahan yang berjaya menempah kredit; penjanaan yang gagal menggunakan peraturan bayaran balik sedia ada. Hasil yang tidak diketahui kekal ditahan untuk semakan. HTTP 401 bermaksud kunci tidak sah/dibatalkan, 402 kredit tidak mencukupi, 403 akses akaun tidak tersedia, 409 konflik permintaan atau gerbang penjanaan, 429 had permintaan harian, dan 503 jualan API dijeda. Pengundian status dan muat turun juga dikira dalam elaun permintaan harian; undi secara konservatif.

Keluaran API pertama ini hanya menyokong gesaan teks. Rujukan muat naik, avatar, muzik, suara dan aliran kerja sembang kekal di studio. Sasaran margin kasar tidak termasuk yuran pembayaran, pengehosan dan cukai. Kunci API terikat pada akaun anda dan berhenti berfungsi apabila dibatalkan, apabila akses dilumpuhkan atau selepas perubahan kata laluan.