Gawe tanggapan teks
Gunakake API Tanggapan ShareAI kanggo generasi teks tanpa status, riwayat obrolan eksplisit, lan acara streaming Tanggapan.
Ing kaca iki
https://api.shareai.now/api/v1/responsesNgasilake tanggapan teks saka prompt utawa obrolan.
- URL Dasar
https://api.shareai.now- Otentikasi
- Bearer API key utawa token akses OAuth sing disetujui
Pilih API iki nalika aplikasi sampeyan nggunakake format pesen teks Tanggapan. Pasok obrolan ing saben panjalukan; tanggapan ora disimpen kanggo dijupuk mengko.
Kirim panjalukan#
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());
Lapangan panjalukan#
| Lapangan | Nilai |
|---|---|
model | Model obrolan sing kasedhiya lan diidini dening kredensialmu. |
input | String sing ora kosong, utawa nganti 256 pesen teks. |
instructions | Instruksi sistem opsional sing disisipake ing obrolan. |
store | false; nyimpen tanggapan ora didhukung. |
stream | false kanggo JSON utawa true kanggo acara SSE Tanggapan. |
Nerusake obrolan#
Kirim pesen sadurungé ing input bebarengan karo pesen pangguna sabanjure. Peran sing didhukung yaiku user, assistant, system lan developer. Instruksi pangembang nggunakake peran sistem sacara internal. Isi pesen bisa dadi teks utawa input_text/output_text bagean.
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
}
Maca asil#
Tanggapan JSON yaiku response obyek. Maca teks asisten saka output[].content[] entri kanthi jinis output_text. Priksa status tanggapan: completed yaiku tanggapan rampung; incomplete bisa nuduhake wates token. Publik usage saiki null; gunakake Panggunaan Konsol kanggo mriksa panggunaan sing diproses.
Streaming tanggapan#
Setel stream: true lan parse SSE. Acara kalebu response.created, response.output_text.delta lan terminal response.completed, response.incomplete utawa response.failed. Tambah delta teks kanthi urutan lan tangani status terminal kanthi eksplisit.
Subset sing didhukung#
Titik akhir iki ndhukung generasi teks. Tanggapan sing disimpen, previous_response_id, retrieval/deletion, piranti, input gambar, panjalukan latar mburi lan setelan generasi kaya temperature ora didhukung lan ditolak. Kanggo setelan generasi berbasis pesen sing didhukung dening Chat Completions, gunakake Obrolan Rampung.
Gunakake token akses OAuth#
Ganti kunci API ing header Authorization nganggo token akses OAuth sing disetujui. The surcharge lingkup lan rencana panggunaan sing ditampa dibutuhake kanggo inferensi sing didanai akun. Lingkup identitas-only ora ngidini pengeluaran. Deleng lingkup lan izin.
Paling anyar dianyari Septèmber 15, 2026