உரையாடல் நிறைவுகளை உருவாக்கவும்
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 '{
"provider": {
"sort": {
"by": "price",
"direction": "asc"
}
},
"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 = {'provider': {'sort': {'by': 'price', 'direction': 'asc'}}, '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 = {
"provider": {
"sort": {
"by": "price",
"direction": "asc"
}
},
"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 அணுகல் டோக்கனைப் பயன்படுத்தவும்
மாடல் அடையாளம் மற்றும் செயல்பாட்டு வழங்குநர்கள்#
உருவாக்குநரின் அடிப்படையிலான மாடல் அடையாளத்தை துல்லியமாக நகலெடுக்கவும் மாதிரிகள். விருப்பத்தேர்வுடன் உள்கட்டமைப்பை தனியாகத் தேர்ந்தெடுக்கவும் provider பொருள். இயல்புநிலை விலை அடிப்படையில் தகுதியான வழங்குநர்களை தரவரிசைப்படுத்துகிறது, குறைந்தது முதல். வழங்குநர்களைத் தேர்ந்தெடுக்கவும் அல்லது ஆலோசனை செய்யவும் முழுமையான கொள்கை குறிப்பை.
கடைசியாக புதுப்பிக்கப்பட்டது செப்டம்பர் 16, 2026