Yi buƙatar API ɗinka na farko
Ƙirƙiri maɓallin API na ShareAI, zaɓi samfurin da ake da shi sannan ka aika da buƙatar hira daga uwar garkenka tare da tabbatar da Bearer.
A wannan shafin
Fara nan lokacin da aikace-aikacenka zai yi buƙatu ta amfani da maɓallin API daga wurin aikin ShareAI naka. Kana buƙatar asusun ShareAI, maɓalli mai aiki da kuma damar zuwa samfurin da kake son gudanarwa.
1. Ƙirƙiri maɓallin API#
Bude Console ShareAI kuma zaɓi wurin aikin da zai mallaki maɓallin da amfani. Buɗe Maɓallan API, zaɓi Ƙirƙiri maɓallin API, ka ba maɓallin suna da za a iya gane shi sannan ka ajiye sirrin a cikin yanayin uwar garkenka.


2. Zaɓi samfurin#
Bude Samfura kuma kwafi ainihin mai gano samfurin da aka nuna a can. Duba samuwar yanzu da takurawar samfurin/mai bayarwa akan maɓallinka. Mai gano a cikin koyarwar tsoho ba ya tabbatar da cewa ƙarfin yana samuwa a yau.
3. Aika buƙatar#
https://api.shareai.now/api/v1/chat/completionsƘirƙiri amsa ta amfani da samfurin da ake da shi.
- URL na Asali
https://api.shareai.now- Tantancewa
- Maɓallin Bearer API
Sauya MODEL_IDENTIFIER tare da mai gano da ka zaɓa. Saita SHAREAI_API_KEY a cikin yanayinka kafin gudanar da misalin.
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. Karanta sakamakon#
Don buƙatar da ba ta gudana kai tsaye ba mai nasara, tabbatar da cewa done gaskiya ne sannan ka karanta saƙon mataimaki daga message.content. Duba duka matsayin HTTP da duk wani abu na kuskure a cikin jikin kafin ka ɗauke shi a matsayin kammalawa mai nasara. Sakamakon babu-na'ura na iya zuwa a halin yanzu a matsayin abu na kuskure tare da HTTP 200.
Idan buƙatar ta kasa#
| Matsayi | Mataki na gaba |
|---|---|
| 401 | Duba maɓalli, wurin aiki da taken Izini. |
| 402 | Duba ƙididdiga da ake da su ko ma'aunin da ya dace. |
| 403 | Duba samfurori da masu bayarwa da aka yarda. |
| 429 | Jira Retry-After idan yana nan, sannan ka sake gwadawa tare da jinkiri mai iyaka. |
| 503 | Duba ƙarfin yanzu ko samuwar sabis; ka kiyaye iyakar sake gwadawa. |
Matakai na gaba#
Bayanin buƙatar hira da amsa yana bayyana jikin da aka tallafa. Idan kowanne abokin ciniki ya kamata ya ba da izini ga asusunsu, bi OAuth na aikace-aikace.
An sabunta karshe ranar 15 ga Satumba, 2026