Buat permintaan API pertama Anda
Buat kunci API ShareAI, pilih model yang tersedia, dan kirim permintaan chat dari server Anda dengan autentikasi Bearer.
Di halaman ini
Mulai di sini ketika aplikasi Anda akan membuat permintaan menggunakan kunci API dari ruang kerja ShareAI Anda sendiri. Anda memerlukan akun ShareAI, kunci aktif, dan akses ke model yang ingin Anda jalankan.
1. Buat kunci API#
Buka Konsol ShareAI dan pilih ruang kerja yang akan memiliki kunci dan penggunaan. Buka Kunci API, pilih Buat kunci API, beri nama yang mudah dikenali untuk kunci tersebut dan simpan rahasia di lingkungan server Anda.


2. Pilih model#
Buka Model dan salin pengidentifikasi model yang tepat yang ditampilkan di sana. Periksa ketersediaan saat ini dan pembatasan model/provider pada kunci Anda. Pengidentifikasi dalam tutorial lama tidak menjamin kapasitas tersedia hari ini.
3. Kirim permintaan#
https://api.shareai.now/api/v1/chat/completionsHasilkan respons menggunakan model yang tersedia.
- URL Dasar
https://api.shareai.now- Otentikasi
- API key Bearer
Ganti MODEL_IDENTIFIER dengan pengidentifikasi yang Anda pilih. Atur SHAREAI_API_KEY di lingkungan Anda sebelum menjalankan contoh.
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/chat/completions" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "MODEL_IDENTIFIER",
"messages": [
{
"role": "user",
"content": "Explain what ShareAI does in one sentence."
}
],
"stream": false
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'MODEL_IDENTIFIER', 'messages': [{'role': 'user', 'content': 'Explain what ShareAI does in one sentence.'}], 'stream': False}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/chat/completions', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/chat/completions";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "MODEL_IDENTIFIER",
"messages": [
{
"role": "user",
"content": "Explain what ShareAI does in one sentence."
}
],
"stream": false
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
4. Baca hasilnya#
Untuk permintaan non-streaming yang berhasil, periksa bahwa done bernilai true dan baca pesan asisten dari message.content. Periksa status HTTP dan objek kesalahan apa pun di body sebelum menganggapnya sebagai penyelesaian yang berhasil. Hasil no-device saat ini dapat tiba sebagai objek kesalahan dengan HTTP 200.
Jika permintaan gagal#
| Status | Langkah berikutnya |
|---|---|
| 401 | Periksa kunci, ruang kerja, dan header Authorization. |
| 402 | Periksa kredit yang tersedia atau saldo yang berlaku. |
| 403 | Periksa model dan provider yang diizinkan. |
| 429 | Tunggu Retry-After jika ada, lalu coba lagi dengan penundaan yang terbatas. |
| 503 | Periksa kapasitas saat ini atau ketersediaan layanan; tetap gunakan batas retry. |
Langkah berikutnya#
Referensi permintaan dan respons chat menjelaskan body yang didukung. Jika setiap pelanggan harus mengotorisasi akun mereka sendiri, ikuti OAuth aplikasi.
Terakhir diperbarui 15 September 2026