உங்கள் முதல் API கோரிக்கையை உருவாக்கவும்
ShareAI API விசையை உருவாக்கி, கிடைக்கும் மாடலைத் தேர்ந்தெடுத்து, உங்கள் சர்வரிலிருந்து Bearer அங்கீகாரம் கொண்ட ஒரு உரையாடல் கோரிக்கையை அனுப்பவும்.
இந்த பக்கத்தில்
உங்கள் பயன்பாடு உங்கள் சொந்த ShareAI வேலைப்பகுதியிலிருந்து API விசையைப் பயன்படுத்தி கோரிக்கைகளைச் செய்யும் போது இங்கே தொடங்கவும். உங்களுக்கு ShareAI கணக்கு, செயலில் உள்ள விசை மற்றும் நீங்கள் இயக்க விரும்பும் மாடலுக்கான அணுகல் தேவை.
1. API விசையை உருவாக்கவும்#
திறக்கவும் ஷேர்AI கன்சோல் மற்றும் விசையைச் சொந்தமாக்கும் வேலைப்பகுதியைத் தேர்ந்தெடுக்கவும். திறக்கவும் API கீக்கள், தேர்ந்தெடுக்கவும் API விசையை உருவாக்கவும்., விசைக்கு ஒரு அறியப்பட்ட பெயரை வழங்கி, ரகசியத்தை உங்கள் சர்வர் சூழலில் சேமிக்கவும்.


2. ஒரு மாடலைத் தேர்ந்தெடுக்கவும்#
திறக்கவும் மாதிரிகள் அங்கு காட்டப்பட்டுள்ள மாடல் அடையாளத்தை சரியாக நகலெடுக்கவும். உங்கள் கீயில் உள்ள தற்போதைய கிடைப்பதையும் மாடல்/வழங்குநர் கட்டுப்பாடுகளையும் சரிபார்க்கவும். பழைய டுடோரியல் ஒன்றில் உள்ள அடையாளம் இன்று திறன் கிடைப்பதை உறுதிப்படுத்தாது.
3. கோரிக்கையை அனுப்பவும்#
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. முடிவை வாசிக்கவும்#
வெற்றிகரமான non-streaming கோரிக்கைக்காக, done உண்மையானது என்பதை சரிபார்க்கவும் மற்றும் உதவியாளர் செய்தியை message.content. இருந்து வாசிக்கவும். HTTP நிலை மற்றும் உடலில் உள்ள எந்தவொரு பிழை பொருளையும் வெற்றிகரமான நிறைவு எனக் கருதுவதற்கு முன் சரிபார்க்கவும். ஒரு சாதனம் இல்லாத முடிவு தற்போது HTTP 200 உடன் பிழை பொருளாக வரலாம்.
கோரிக்கை தோல்வியடைந்தால்#
| நிலை | அடுத்த படி |
|---|---|
| 401 | முக்கியக் குறியீடு, வேலைத்தளம் மற்றும் Authorization header ஐ சரிபார்க்கவும். |
| 402 | கிடைக்கக்கூடிய கிரெடிட்கள் அல்லது பொருந்தக்கூடிய இருப்பு தொகையை சரிபார்க்கவும். |
| 403 | அனுமதிக்கப்பட்ட மாடல்கள் மற்றும் வழங்குநர்களை சரிபார்க்கவும். |
| 429 | Retry-After இருப்பின் காத்திருக்கவும், பின்னர் கட்டுப்படுத்தப்பட்ட தாமதத்துடன் மீண்டும் முயற்சிக்கவும். |
| 503 | தற்போதைய திறன் அல்லது சேவை கிடைக்குமா என்பதை சரிபார்க்கவும்; மீண்டும் முயற்சிக்கும் வரம்பை வைத்திருக்கவும். |
அடுத்த படிகள்#
உரையாடல் கோரிக்கை மற்றும் பதில் குறிப்பு ஆதரிக்கப்படும் உடல் விளக்குகிறது. ஒவ்வொரு வாடிக்கையாளரும் தங்களது கணக்கை அங்கீகரிக்க வேண்டும் என்றால், பின்பற்றவும் பயன்பாட்டு OAuth.
கடைசியாக புதுப்பிக்கப்பட்டது செப்டம்பர் 15, 2026