Creează un răspuns text
Folosește API-ul ShareAI Responses pentru generarea de text fără stare, istoricul explicit al conversațiilor și evenimentele de streaming Responses.
Pe această pagină
https://api.shareai.now/api/v1/responsesGenerează un răspuns text dintr-un prompt sau o conversație.
- URL de bază
https://api.shareai.now- Autentificare
- Cheie API Bearer sau token de acces OAuth aprobat
Alege acest API atunci când aplicația ta folosește formatul de mesaje text Responses. Furnizează conversația la fiecare solicitare; răspunsurile nu sunt stocate pentru recuperare ulterioară.
Trimite o cerere#
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/responses" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_CHAT_MODEL",
"input": "Explain semantic search in two sentences.",
"instructions": "Use plain language.",
"store": false,
"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': 'YOUR_CHAT_MODEL', 'input': 'Explain semantic search in two sentences.', 'instructions': 'Use plain language.', 'store': False, 'stream': False}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/responses', 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/responses";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "YOUR_CHAT_MODEL",
"input": "Explain semantic search in two sentences.",
"instructions": "Use plain language.",
"store": false,
"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());
Câmpuri cerere#
| Câmp | Valoare |
|---|---|
model | Un model de chat disponibil permis de acreditivul tău. |
input | Un șir nevid sau până la 256 de mesaje text. |
instructions | Instrucțiuni de sistem opționale adăugate la începutul conversației. |
store | false; stocarea răspunsurilor nu este suportată. |
stream | false pentru JSON sau true pentru evenimente SSE Responses. |
Continuă o conversație#
Trimite mesajele anterioare în input alături de următorul mesaj al utilizatorului. Rolurile suportate sunt user, assistant, system și developer. Instrucțiunile dezvoltatorului folosesc rolul de sistem intern. Conținutul mesajului poate fi text sau input_text/output_text părți.
JSON
{
"model": "YOUR_CHAT_MODEL",
"input": [
{
"role": "user",
"content": "What is semantic search?"
},
{
"role": "assistant",
"content": "It finds results by meaning rather than exact words."
},
{
"role": "user",
"content": "Give one example."
}
],
"store": false
}
Citește rezultatul#
Răspunsul JSON este un response obiect. Citește textul asistentului din output[].content[] intrări cu tipul output_text. Verifică starea răspunsului: completed este un răspuns finalizat; incomplete poate indica o limită de token-uri. Public usage este în prezent null; folosește Utilizare în Consolă pentru a inspecta utilizarea procesată.
Transmite un răspuns în flux#
Setează stream: true și analizează SSE. Evenimentele includ response.created, response.output_text.delta și un terminal response.completed, response.incomplete sau response.failed. Adaugă deltele text în ordine și gestionează explicit starea terminalului.
Subset suportat#
Acest endpoint suportă generarea de text. Răspunsurile stocate, previous_response_id, recuperarea/ștergerea, uneltele, intrările de imagine, solicitările în fundal și setările de generare precum temperature nu sunt acceptate și sunt respinse. Pentru setările de generare bazate pe mesaje acceptate de Chat Completions, folosește Completări de chat.
Utilizează un token de acces OAuth#
Înlocuiește cheia API din antetul Authorization cu un token de acces OAuth aprobat. surcharge domeniul și planul de utilizare acceptat sunt necesare pentru inferența finanțată din cont. Domeniile doar pentru identitate nu autorizează cheltuieli. Vezi domenii și permisiuni.
Ultima actualizare: 15 septembrie 2026