Unda jibu la maandishi

Tumia ShareAI Responses API kwa kizazi cha maandishi bila hali, historia ya mazungumzo wazi na matukio ya Responses streaming.

Tazama kama Markdown

Kwenye ukurasa huu

POST https://api.shareai.now/api/v1/responses

Tengeneza jibu la maandishi kutoka kwa mwongozo au mazungumzo.

URL ya Msingi: https://api.shareai.now
Uthibitishaji: Funguo ya API ya Bearer au tokeni ya ufikiaji ya OAuth iliyokubaliwa

Chagua API hii wakati programu yako inatumia muundo wa ujumbe wa maandishi wa Responses. Toa mazungumzo kwa kila ombi; majibu hayahifadhiwi kwa urejeshaji wa baadaye.

Tuma ombi#

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());

Sehemu za ombi#

Sehemu	Thamani
`model`	Mfano wa mazungumzo unaopatikana na unaoruhusiwa na kitambulisho chako.
`input`	Mstari usio tupu, au hadi ujumbe wa maandishi 256.
`instructions`	Maagizo ya mfumo ya hiari yaliyoambatanishwa mwanzoni mwa mazungumzo.
`store`	`false`; kuhifadhi majibu hakusaidiwi.
`stream`	`false` kwa JSON au `true` kwa matukio ya Responses SSE.

Endelea na mazungumzo#

Tuma ujumbe wa awali katika input pamoja na ujumbe wa mtumiaji unaofuata. Nafasi zinazosaidiwa ni user, assistant, system na developer. Maagizo ya msanidi hutumia nafasi ya mfumo ndani. Maudhui ya ujumbe yanaweza kuwa maandishi au input_text/output_text sehemu.

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
}

Soma matokeo#

Jibu la JSON ni response kitu. Soma maandishi ya msaidizi kutoka output[].content[] maingizo yenye aina output_text. Angalia hali ya jibu: completed ni jibu lililokamilika; incomplete inaweza kuonyesha kikomo cha tokeni. Umma usage kwa sasa ni null; tumia Matumizi ya Console kukagua matumizi yaliyosindikwa.

Mtiririshe jibu#

Weka stream: true na parse SSE. Matukio yanajumuisha response.created, response.output_text.delta na hali ya mwisho response.completed, response.incomplete au response.failed. Ongeza deltas za maandishi kwa mpangilio na ushughulikie hali ya mwisho waziwazi.

Sehemu ndogo inayosaidiwa#

Endpoint hii inasaidia kizazi cha maandishi. Majibu yaliyohifadhiwa, previous_response_id, upatikanaji/ufutaji, zana, pembejeo za picha, maombi ya mandharinyuma na mipangilio ya kizazi kama temperature hazitumiki na zinakataliwa. Kwa mipangilio ya kizazi inayotegemea ujumbe inayoungwa mkono na Chat Completions, tumia Mazungumzo Kamili.

Tumia tokeni ya ufikiaji ya OAuth#

Badilisha kitufe cha API kwenye kichwa cha Authorization na ishara ya ufikiaji ya OAuth iliyoidhinishwa. surcharge wigo na mpango wa matumizi uliokubaliwa unahitajika kwa inference inayofadhiliwa na akaunti. Wigo wa utambulisho pekee hauidhinishi matumizi ya fedha. Tazama wigo na ruhusa.

Ilisasishwa mwisho Septemba 15, 2026