Gumawa ng iyong unang API request
Gumawa ng ShareAI API key, pumili ng magagamit na modelo, at magpadala ng chat request mula sa iyong server gamit ang Bearer authentication.
Sa pahinang ito
Simulan dito kapag ang iyong aplikasyon ay gagawa ng mga request gamit ang API key mula sa sarili mong ShareAI workspace. Kailangan mo ng ShareAI account, aktibong key, at access sa modelo na nais mong patakbuhin.
1. Gumawa ng API key#
Buksan ShareAI Console at piliin ang workspace na magmamay-ari ng key at paggamit. Buksan Mga Susi ng API, pumili Gumawa ng API key, bigyan ang key ng madaling makikilalang pangalan, at i-save ang secret sa iyong server environment.


2. Pumili ng modelo#
Buksan Mga Modelo at kopyahin ang eksaktong identifier ng modelo na ipinapakita doon. Suriin ang kasalukuyang availability at ang mga limitasyon ng modelo/provider sa iyong key. Ang identifier sa lumang tutorial ay hindi ginagarantiya na ang kapasidad ay magagamit ngayon.
3. Magpadala ng request#
https://api.shareai.now/api/v1/chat/completionsBumuo ng tugon gamit ang magagamit na modelo.
- Base URL
https://api.shareai.now- Pagpapatunay
- Bearer API key
Palitan MODEL_IDENTIFIER gamit ang napiling identifier. Itakda SHAREAI_API_KEY sa iyong environment bago patakbuhin ang halimbawa.
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. Basahin ang resulta#
Para sa matagumpay na non-streaming request, suriin na ang done ay true at basahin ang mensahe ng assistant mula sa message.content. Suriin ang parehong HTTP status at anumang error object sa body bago ito ituring na matagumpay na pagkumpleto. Ang resulta na walang device ay maaaring dumating bilang error object na may HTTP 200.
Kapag nabigo ang request#
| Katayuan | Susunod na hakbang |
|---|---|
| 401 | Suriin ang key, workspace, at Authorization header. |
| 402 | Suriin ang magagamit na credits o ang naaangkop na balanse. |
| 403 | Suriin ang mga pinapayagang modelo at provider. |
| 429 | Maghintay para sa Retry-After kapag naroroon, pagkatapos ay subukang muli na may limitadong delay. |
| 503 | Suriin ang kasalukuyang kapasidad o availability ng serbisyo; panatilihin ang limitasyon sa retry. |
Mga susunod na hakbang#
Reference ng chat request at response ipinaliwanag ang suportadong body. Kung ang bawat customer ay dapat mag-awtorisa ng sarili nilang account, sundin ang aplikasyon OAuth.
Huling na-update noong Setyembre 15, 2026