Ƙirƙiri amsar rubutu
Yi amfani da ShareAI Responses API don samar da rubutu ba tare da yanayi ba, tarihin tattaunawa na musamman da abubuwan streaming na Responses.
A wannan shafin
https://api.shareai.now/api/v1/responsesSamar da amsar rubutu daga tambaya ko tattaunawa.
- URL na Asali
https://api.shareai.now- Tantancewa
- Maɓallin API na Bearer ko takardar izinin shiga OAuth da aka amince da ita
Zaɓi wannan API lokacin da aikace-aikacenka ke amfani da tsarin saƙon rubutu na Responses. Samar da tattaunawa a kowane buƙata; ba a adana amsoshi don dawo da su daga baya ba.
Aika buƙata#
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());
Filayen buƙata#
| Filin | Daraja |
|---|---|
model | Samfurin tattaunawa da ake da shi wanda izinin ka ya yarda da shi. |
input | Rubutu mara komai, ko har zuwa saƙonni 256 na rubutu. |
instructions | Zaɓin umarnin tsarin da aka haɗa a farkon tattaunawar. |
store | false; ba a tallafa adana amsoshi ba. |
stream | false don JSON ko true don abubuwan Responses SSE. |
Ci gaba da tattaunawa#
Aika saƙonni na baya a input tare da saƙon mai amfani na gaba. Matsayin da aka tallafa su ne user, assistant, system kuma developer. Umarnin mai haɓakawa suna amfani da matsayin tsarin a ciki. Abun cikin saƙon na iya zama rubutu ko input_text/output_text sassa.
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
}
Karanta sakamakon#
Amsar JSON abu ne response abu. Karanta rubutun mataimaki daga output[].content[] shigarwa tare da nau'in output_text. Duba matsayin amsa: completed amsa ce da aka kammala; incomplete na iya nuna iyakar token. Jama'a usage a halin yanzu null ne; yi amfani da Console Usage don bincika amfani da aka sarrafa.
Rafi amsa#
Saita stream: true da fassara SSE. Abubuwan sun haɗa da response.created, response.output_text.delta da ƙarshen response.completed, response.incomplete ko response.failed. Haɗa deltas na rubutu a tsari kuma sarrafa matsayin ƙarshen a fili.
Rukunin da aka tallafa#
Wannan ƙarshen yana tallafawa samar da rubutu. Amsoshin da aka adana, previous_response_id, dawo/deleshon, kayan aiki, shigar hotuna, buƙatun bango da saitunan samarwa kamar temperature ba a goyan baya kuma an ƙi su. Don saitunan samarwa bisa saƙonni da Chat Completions ke goyan baya, yi amfani da Cikakkun Hira.
Yi amfani da alamar samun damar OAuth#
Maye gurbin maɓallin API a cikin kanun Authorization da ingantaccen OAuth access token. surcharge ana buƙatar iyaka da shirin amfani da aka amince da shi don inference da aka tallafa da asusu. Iyakar tantancewa kawai ba ta ba da izinin kashe kuɗi ba. Duba iyakoki da izini.
An sabunta karshe ranar 15 ga Satumba, 2026