Buat penyelesaian obrolan
Kirim permintaan chat-completions ShareAI dengan API key Bearer dan pahami model yang didukung, pesan, dan bidang stream.
Di halaman ini
https://api.shareai.now/api/v1/chat/completionsJalankan permintaan chat menggunakan model yang dipilih.
- URL Dasar
https://api.shareai.now- Otentikasi
- API key Bearer
Ini adalah jalur integrasi default untuk permintaan yang dibayar dan diotorisasi oleh workspace API-key Anda. Pembatasan model dan penyedia pada key berlaku untuk alokasi, termasuk jalur fallback yang diizinkan.
Badan permintaan#
| Bidang | Tipe | Makna |
|---|---|---|
model | string, wajib | Identifier model yang tersedia secara tepat. Salin dari Models. |
messages | array | Pesan percakapan yang berisi peran dan konten. |
stream | boolean | false mengembalikan satu hasil JSON; true meminta server-sent events. |
Gunakan konten pesan teks. Kirim peran seperti system, user dan assistant sesuai dengan percakapan. Sertakan riwayat percakapan yang ingin Anda gunakan oleh model; jangan berasumsi permintaan berbagi percakapan yang tersimpan.
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": "system",
"content": "Be concise and helpful."
},
{
"role": "user",
"content": "Give me three ideas for a local community event."
}
],
"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': 'system', 'content': 'Be concise and helpful.'}, {'role': 'user', 'content': 'Give me three ideas for a local community event.'}], '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": "system",
"content": "Be concise and helpful."
},
{
"role": "user",
"content": "Give me three ideas for a local community event."
}
],
"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());
Respons#
Hasil non-streaming yang selesai mengatur done ke true dan mengembalikan teks yang dihasilkan di message.content. Tingkat atas juga membawa done_reason dan consumption_type. Streaming menggunakan format berbeda, chat-completion-chunk. Jangan berasumsi hasil non-streaming memiliki array pilihan gaya OpenAI.
JSON
{
"done": true,
"done_reason": "stop",
"consumption_type": "credits",
"message": {
"role": "assistant",
"content": "Here are three ideas for your community event.",
"done": true,
"done_reason": "stop"
}
}
Ini adalah hasil selesai ilustratif; consumption_type menggambarkan mode alokasi aktual. Periksa kesalahan tingkat atas bahkan ketika status HTTP adalah 200. Hasil tanpa perangkat saat ini menggunakan error.code = no_device dengan HTTP 200.
Pembatasan model dan penyedia#
Sebuah key mungkin dibatasi untuk model tertentu dan penyedia eksekusi. Jika akses ditolak, periksa informasi key dan perbarui key di Console hanya jika workspace pemilik bermaksud memberikan akses tersebut.
Streaming atau otorisasi pelanggan#
Terakhir diperbarui 15 September 2026