第一次 API 請求
創建一個 ShareAI API 密鑰,揀一個可用模型,並從你嘅伺服器用 Bearer 認證發送聊天請求。
喺呢頁面
當你嘅應用程式將使用來自你自己 ShareAI 工作區嘅 API 密鑰發送請求時,從呢度開始。你需要一個 ShareAI 帳戶、一個有效密鑰同訪問你想運行嘅模型嘅權限。
1. 創建 API 密鑰#
打開 ShareAI控制台 並選擇將擁有密鑰同使用權嘅工作區。打開 API 鑰匙, ,揀選 建立 API 鑰匙,畀密鑰一個可識別嘅名稱,並將秘密保存喺你嘅伺服器環境中。


2. 揀一個模型#
打開 模型 複製嗰度顯示嘅準確模型識別碼。檢查當前可用性同埋你嘅密鑰上嘅模型/供應商限制。舊教程入面嘅識別碼唔保證今日仲有容量可用。
3. 發送請求#
POST
https://api.shareai.now/api/v1/chat/completions用一個可用嘅模型生成回應。
- 基礎 URL
https://api.shareai.now- 認證
- Bearer API 密鑰
替換 MODEL_IDENTIFIER 用你揀嘅識別碼。設定 SHAREAI_API_KEY 喺你嘅環境入面,喺運行示例之前。
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. 閱讀結果#
對於一個成功嘅非流式請求,檢查 done 係咪 true,並從 message.content. 讀取助手消息。喺將其視為成功完成之前,檢查 HTTP 狀態同埋正文入面嘅任何錯誤對象。目前,無設備結果可能會以 HTTP 200 嘅錯誤對象形式出現。
如果請求失敗#
| 狀態 | 下一步 |
|---|---|
| 401 | 檢查密鑰、工作區同授權標頭。 |
| 402 | 檢查可用嘅信用額或者適用餘額。 |
| 403 | 檢查允許嘅模型同供應商。 |
| 429 | 當有 Retry-After 時等候,然後用有限嘅延遲重試。 |
| 503 | 檢查當前容量或者服務可用性;保持重試限制。 |
下一步#
聊天請求同回應參考。 解釋支持嘅正文。如果每個客戶都需要授權佢哋自己嘅帳戶,請遵循 應用 OAuth。.
最後更新日期:2026年9月15日