API Orkas

Dokumentasi API Orkas

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.

Buat kunci API

Obrolan

Gunakan format Penyelesaian Obrolan yang kompatibel dengan OpenAI dalam aplikasi AI, alat baris perintah, atau layanan Anda sendiri.

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.
`API Key`	Buat kunci di Akun	Tempelkan kunci ke dalam bidang kunci API aplikasi.
`model`	`orkas-llm-1.5`Direkomendasikan	Terbaik untuk tanya jawab sehari-hari, menulis, dan pekerjaan kantor. Termasuk DeepSeek V4.1 Flash · GPT-6 Luna · Claude-Sonnet-5 · Gemini-3.8 Flash.
`model`	`orkas-llm-1.5-pro`	Terbaik untuk penelitian, video, R&D, dan tugas kompleks lainnya. Termasuk GPT-6 Sol · Claude Opus 5.5 · Kimi K3.

Membuat penyelesaian obrolan

Titik akhir

POST

https://orkas.ai/v1/chat/completions

Membuat penyelesaian obrolan

Otentikasi

Authorization: Bearer $ORKAS_API_KEY

Parameter tubuh permintaan

Parameter	Jenis	Diperlukan	Deskripsi
`model`	string	Ya	`orkas-llm-1.5` atau `orkas-llm-1.5-pro`.
`messages`	array	Ya	Pesan percakapan. Setiap item berisi `role` dan `content`.
`stream`	boolean	Tidak	Kembalikan respons streaming ketika `true`. Standar: `false`.

Minta contoh

curl https://orkas.ai/v1/chat/completions \
  -H "Authorization: Bearer $ORKAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "orkas-llm-1.5",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Penggunaan kredit

Item penagihan	Debit kredit	Unit penagihan
`orkas-llm-1.5`	Masukan 20–280; cache membaca 2–28; cache membuat 25–350; output 120–1.260	Per 1 juta token; tarif yang tepat tergantung pada permintaan.
`orkas-llm-1.5-pro`	Masukan 140–1.000; cache membaca 14–100; cache membuat 175–1.250; output 840–4.500	Per 1 juta token; tarif yang tepat tergantung pada permintaan.

Pencarian

Cari di web dan kembalikan daftar ringkas hasil yang relevan untuk aplikasi Anda.

Cari di web

Titik akhir

POST

https://orkas.ai/v1/search

Cari di web

Otentikasi

Authorization: Bearer $ORKAS_API_KEY

Parameter tubuh permintaan

Parameter	Jenis	Diperlukan	Deskripsi
`query`	string	Ya	Cari teks, hingga 2.000 karakter.
`max_results`	integer	Tidak	Jumlah hasil, 1-20. Standar: `8`.

Minta contoh

curl https://orkas.ai/v1/search \
  -H "Authorization: Bearer $ORKAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"latest battery research","max_results":8}'

Penggunaan kredit

Item penagihan	Debit kredit	Unit penagihan
Cari di web	5.6	Per permintaan, hingga 20 hasil.

Pidato

Ubah teks menjadi file audio. Pilih ID suara dari daftar di bawah ini dan pilih format audio yang Anda butuhkan.

Daftar suara

Titik akhir

GET

https://orkas.ai/v1/audio/voices

Daftar suara

Otentikasi

Authorization: Bearer $ORKAS_API_KEY

Parameter permintaan

Titik akhir ini tidak memiliki parameter permintaan.

Minta contoh

curl https://orkas.ai/v1/audio/voices \
  -H "Authorization: Bearer $ORKAS_API_KEY"

ID suara yang tersedia

ID Suara	Nama	Bahasa
`zh_female_vv_uranus_bigtts`	vivi 2.0	Cina / Inggris
`saturn_zh_female_cancan_tob`	知性灿灿	Cina
`saturn_zh_female_keainvsheng_tob`	可爱女生	Cina
`saturn_zh_female_tiaopigongzhu_tob`	调皮公主	Cina
`saturn_zh_male_shuanglangshaonian_tob`	爽朗少年	Cina
`saturn_zh_male_tiancaitongzhuo_tob`	天才同桌	Cina
`zh_female_xiaohe_uranus_bigtts`	小何	Cina
`zh_male_m191_uranus_bigtts`	云舟	Cina
`zh_male_taocheng_uranus_bigtts`	小天	Cina
`en_male_tim_uranus_bigtts`	Tim	Bahasa Inggris
`en_female_dacey_uranus_bigtts`	Dacey	Bahasa Inggris
`en_female_stokie_uranus_bigtts`	Stokie	Bahasa Inggris

Menghasilkan pidato

Titik akhir

POST

https://orkas.ai/v1/audio/speech

Menghasilkan pidato

Otentikasi

Authorization: Bearer $ORKAS_API_KEY

Parameter tubuh permintaan

Parameter	Jenis	Diperlukan	Deskripsi
`model`	string	Ya	Gunakan `orkas-tts-1`.
`input`	string	Ya	Teks untuk disintesis, hingga 16.384 UTF-8 byte.
`voice`	string	Ya	ID Suara dari daftar di atas.
`language`	string	Tidak	Bahasa narasi, seperti `zh-CN` atau `Zen`. Itu harus didukung oleh suara yang dipilih; jika tidak, bahasa default suara digunakan.
`response_format`	string	Tidak	`mp3`, `wav`, `opus`, atau `ogg`. Bawaan: `mp3`.
`speed`	number	Tidak	Kecepatan bicara dari 0,5 hingga 2,0. Standar: `1.0`.

Minta contoh

curl https://orkas.ai/v1/audio/speech \
  -H "Authorization: Bearer $ORKAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"orkas-tts-1",
    "input":"你好，欢迎使用 Orkas。",
    "voice":"zh_female_vv_uranus_bigtts",
    "language":"zh-CN",
    "response_format":"mp3",
    "speed":1.0
  }' --output speech.mp3

Penggunaan kredit

Item penagihan	Debit kredit	Unit penagihan
Daftar suara	0	Sesuai permintaan
Menghasilkan pidato	0.125	Per perkiraan keluaran detik, dibulatkan ke atas menjadi setidaknya satu detik.

Gambar

Buat gambar dari deskripsi, atau berikan gambar referensi untuk diedit. Satu gambar dikembalikan per permintaan.

Hasilkan sebuah gambar

Titik akhir

POST

https://orkas.ai/v1/images/generations

Hasilkan sebuah gambar

Otentikasi

Authorization: Bearer $ORKAS_API_KEY

Parameter tubuh permintaan

Parameter	Jenis	Diperlukan	Deskripsi
`prompt`	string	Ya	Deskripsi gambar, hingga 20.000 karakter.
`size`	string	Tidak	`2k`, `3k`, `4k`, atau nilai lebar×tinggi yang didukung. Standar: `2k`.
`response_format`	string	Tidak	`url` atau `b64_json`. Standar: `b64_json`.
`reference_images`	array	Tidak	Hingga empat URL HTTPS atau URL data gambar yang didukung untuk diedit.
`async`	boolean	Tidak	Kembalikan ID tugas saat `true`. Disarankan untuk menghindari batas waktu permintaan. Bawaan: `false`.

Minta contoh

curl https://orkas.ai/v1/images/generations \
  -H "Authorization: Bearer $ORKAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt":"A product photo on a clean studio background",
    "size":"2k",
    "response_format":"url",
    "async":true
  }'

Untuk permintaan yang lebih lama: atur "async": true. API mengembalikan tugas id; gunakan URL status hingga hasilnya siap.

Periksa status generasi

Titik akhir

GET

https://orkas.ai/v1/images/generations/{id}

Periksa status generasi

Otentikasi

Authorization: Bearer $ORKAS_API_KEY

Parameter jalur

Parameter	Jenis	Diperlukan	Deskripsi
`id`	string	Ya	ID tugas dikembalikan oleh permintaan pembuatan.

Minta contoh

curl https://orkas.ai/v1/images/generations/$TASK_ID \
  -H "Authorization: Bearer $ORKAS_API_KEY"

Penggunaan kredit

Item penagihan	Debit kredit	Unit penagihan
Hasilkan sebuah gambar	22	Per gambar yang dihasilkan
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
  }'

Periksa status video

Titik akhir

GET

https://orkas.ai/v1/videos/{id}

Periksa status video

Otentikasi

Authorization: Bearer $ORKAS_API_KEY

Parameter jalur

Parameter	Jenis	Diperlukan	Deskripsi
`id`	string	Ya	ID tugas dikembalikan oleh permintaan pembuatan.

Minta contoh

curl https://orkas.ai/v1/videos/$TASK_ID \
  -H "Authorization: Bearer $ORKAS_API_KEY"

Penggunaan kredit

Item penagihan	Debit kredit	Unit penagihan
`balanced` · Teks atau gambar ke video · 480p	37	Per keluaran detik
`balanced` · Teks atau gambar ke video · 720p	80	Per keluaran detik
`balanced` · Teks atau gambar ke video · 1080p	248	Per keluaran detik
`quality` · Teks atau gambar ke video · 480p	46	Per keluaran detik
`quality` · Teks atau gambar ke video · 720p	100	Per keluaran detik
`quality` · Teks atau gambar ke video · 1080p	248	Per keluaran detik
`balanced` / `quality` · Pengeditan video atau pembuatan video referensi · 480p	51	Per keluaran detik
`balanced` / `quality` · Pengeditan video atau pembuatan video referensi · 720p	109	Per keluaran detik
`balanced` / `quality` · Pengeditan video atau pembuatan video referensi · 1080p	271	Per keluaran detik
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.