Hubungkan kemampuan obrolan, pencarian, ucapan, gambar, dan video Orkas ke alat Anda sendiri. Mulailah dengan Obrolan untuk menemukan URL Dasar, kunci API, dan nama model yang digunakan oleh sebagian besar aplikasi AI.
Chat dan Responses menyediakan respons model serta panggilan fungsi kustom untuk ditangani aplikasi Anda; endpoint gambar dan video menghasilkan media. Panggilan API ini tidak memulai tugas Commander di aplikasi desktop atau otomatis melibatkan agennya. Orkestrasi agen tambahan bergantung pada alur kerja aplikasi Anda.
Pengaturan koneksi
Jika sebuah aplikasi meminta URL Dasar, kunci API, dan model, masukkan nilai-nilai berikut.
Pengaturan
Nilai
Deskripsi
Base URL
https://orkas.ai/v1
Gunakan ini sebagai alamat layanan yang kompatibel dengan OpenAI.
13–23 kredit / gambar keluaran + 5 / gambar masukan
13–23 kredit / gambar keluaran + 5 / gambar masukan (≤2.61 MP: 13; >2.61 MP: 23)
Periksa status generasi
0
Sesuai permintaan
Video-video
Buat video dari teks atau media referensi. Permintaan video berjalan secara asinkron, jadi gunakan ID tugas yang dikembalikan untuk memeriksa kemajuan.
Buat sebuah video
Titik akhir
POST
https://orkas.ai/v1/videos
Buat sebuah video
Otentikasi
Authorization: Bearer $ORKAS_API_KEY
Parameter tubuh permintaan
Parameter
Jenis
Diperlukan
Deskripsi
prompt
string
Ya
Deskripsi video yang akan dibuat atau diedit.
duration
integer
Tidak
4-15 detik. Standar: 5.
resolution
string
Tidak
480p, 720p, atau 1080p. Standar: 720p.
quality
string
Tidak
balanced menyeimbangkan kecepatan dan penggunaan kredit; quality memprioritaskan kualitas dan stabilitas generasi. Standar: balanced. Orkas masih memilih model video yang kompatibel secara otomatis.
ratio
string
Tidak
16:9, 9:16, 1:1, 4:3, 3:4, atau 21:9. Bawaan: 16:9.
generate_audio
boolean
Tidak
Menghasilkan audio video. Standar: true.
reference_image_urls
array
Tidak
Hingga sembilan URL gambar HTTPS publik.
reference_video_urls
array
Tidak
Hingga tiga URL video HTTPS publik.
operation
string
Tidak
generate atau Edit. Pengeditan membutuhkan setidaknya satu video referensi. Standar: generate.
seed
integer
Tidak
Benih opsional untuk generasi yang dapat diulang.
Minta contoh
curl https://orkas.ai/v1/videos \
-H "Authorization: Bearer $ORKAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt":"Camera circles a ceramic lamp in a dark studio",
"duration":5,
"resolution":"720p",
"quality":"balanced",
"ratio":"16:9",
"generate_audio":true
}'
balanced / quality · Pengeditan video atau pembuatan video referensi · 480p
2800
1M tokens Video referensi: token tertagih mencakup video masukan/keluaran dan penggunaan minimum; gambar referensi tanpa biaya terpisah
balanced / quality · Pengeditan video atau pembuatan video referensi · 720p
2800
1M tokens Video referensi: token tertagih mencakup video masukan/keluaran dan penggunaan minimum; gambar referensi tanpa biaya terpisah
balanced / quality · Pengeditan video atau pembuatan video referensi · 1080p
3100
1M tokens Video referensi: token tertagih mencakup video masukan/keluaran dan penggunaan minimum; gambar referensi tanpa biaya terpisah
Periksa status video
0
Sesuai permintaan
Keamanan dan batasan
Jaga kerahasiaan kunci API, gunakan kunci terpisah untuk aplikasi yang berbeda, dan segera hapus kunci jika mungkin telah bocor.
Kirim kunci di Authorization: Bearer sk-orkas-... header permintaan.
Untuk mengelompokkan penggunaan kredit dari satu percakapan, kirim ID opak yang sama dalam X-Orkas-Conversation-Id pada setiap permintaan. Gunakan hanya huruf, angka, -, atau _ (maksimal 64 karakter); jangan kirim judul atau isi pesan.
Jangan masukkan kunci di browser atau kode aplikasi seluler, URL, log, atau kontrol sumber.
Buat kunci terpisah untuk setiap aplikasi sehingga dapat diganti tanpa memengaruhi layanan lainnya.
Batas per-kunci: 120 permintaan/menit untuk obrolan dan pencarian, 60 untuk ucapan, 30 permintaan gambar, dan 10 permintaan video. Pemeriksaan status memungkinkan 120 permintaan/menit.
Jika permintaan terlalu sering, API mengembalikan HTTP 429. Tunggu sebentar sebelum mencoba lagi.
Riwayat kredit
Penggunaan API ditandai secara terpisah dalam riwayat kredit Web Orkas, sehingga Anda dapat membedakannya dari penggunaan di Orkas.