உரையாடல் நிறைவுகளை உருவாக்கவும்
Bearer API key உடன் ShareAI chat-completions கோரிக்கையை அனுப்பி ஆதரிக்கப்பட்ட மாடல், செய்திகள் மற்றும் ஸ்ட்ரீம் புலங்களைப் புரிந்துகொள்ளவும்.
இந்த பக்கத்தில்
https://api.shareai.now/api/v1/chat/completionsதேர்ந்தெடுக்கப்பட்ட மாடலைப் பயன்படுத்தி ஒரு உரையாடல் கோரிக்கையை இயக்கவும்.
- அடிப்படை URL
https://api.shareai.now- அங்கீகாரம்
- Bearer API விசை
இது உங்கள் API-key workspace மூலம் கட்டணம் செலுத்தப்பட்ட மற்றும் அங்கீகரிக்கப்பட்ட கோரிக்கைகளுக்கான இயல்பான ஒருங்கிணைப்பு பாதையாகும். முக்கியத்தின் மாடல் மற்றும் வழங்குநர் கட்டுப்பாடுகள் ஒதுக்கீட்டிற்கு பொருந்தும், அனுமதிக்கப்பட்ட fallback பாதைகளைச் சேர்த்து.
கோரிக்கை உடல்#
| புலம் | வகை | அர்த்தம் |
|---|---|---|
model | string, தேவை | கிடைக்கக்கூடிய மாடல் அடையாளத்தைச் சரியாகக் குறிப்பிடவும். அதை Models இலிருந்து நகலெடுக்கவும். |
messages | வரிசை | பங்கு மற்றும் உள்ளடக்கத்தை உள்ளடக்கிய உரையாடல் செய்திகள். |
stream | பூலியன் | false ஒரு JSON முடிவைத் திருப்புகிறது; true server-sent events கோருகிறது. |
உரை செய்தி உள்ளடக்கத்தைப் பயன்படுத்தவும். பங்குகளை அனுப்பவும் system, user மற்றும் assistant உரையாடலுக்குத் தகுந்தவாறு. மாடல் பயன்படுத்த விரும்பும் உரையாடல் வரலாற்றைச் சேர்க்கவும்; கோரிக்கைகள் சேமிக்கப்பட்ட உரையாடலைப் பகிர்ந்து கொள்கின்றன என்று கருத வேண்டாம்.
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());
பதில்#
முடிக்கப்பட்ட non-streaming முடிவு done true ஆக அமைக்கப்பட்டு message.content. உருவாக்கப்பட்ட உரையை திருப்புகிறது. மேல் நிலை கூட done_reason மற்றும் consumption_type. கொண்டிருக்கும். ஸ்ட்ரீமிங் ஒரு வேறுபட்ட, chat-completion-chunk வடிவத்தைப் பயன்படுத்துகிறது. non-streaming முடிவில் OpenAI-style choices array உள்ளது என்று கருத வேண்டாம்.
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"
}
}
இது ஒரு விளக்கமான முடிக்கப்பட்ட முடிவாகும்; consumption_type உண்மையான ஒதுக்கீட்டு முறையை விவரிக்கிறது. HTTP நிலை 200 இருந்தாலும் கூட மேல் நிலை பிழையைச் சரிபார்க்கவும். தற்போது ஒரு no-device முடிவு error.code = no_device HTTP 200 உடன் பயன்படுத்துகிறது.
மாடல் மற்றும் வழங்குநர் கட்டுப்பாடுகள்#
ஒரு key குறிப்பிட்ட மாடல்கள் மற்றும் செயல்பாட்டு வழங்குநர்களுக்கு மட்டுமே வரையறுக்கப்படலாம். அணுகல் மறுக்கப்பட்டால், key தகவலை ஆய்வு செய்யவும் மற்றும் Console இல் key ஐ புதுப்பிக்கவும், உரிமையுடைய workspace அந்த அணுகலை வழங்க விரும்பினால் மட்டுமே.
ஸ்ட்ரீமிங் அல்லது வாடிக்கையாளர் அங்கீகாரம்#
ஒரு பதிலை ஸ்ட்ரீம் செய்யவும் · OAuth அணுகல் டோக்கனைப் பயன்படுத்தவும்
கடைசியாக புதுப்பிக்கப்பட்டது செப்டம்பர் 15, 2026