Buat respons teks
Gunakan API Respons ShareAI untuk pembuatan teks tanpa status, riwayat percakapan eksplisit, dan streaming event Respons.
Di halaman ini
https://api.shareai.now/api/v1/responsesHasilkan respons teks dari prompt atau percakapan.
- URL Dasar
https://api.shareai.now- Otentikasi
- Kunci API Bearer atau token akses OAuth yang disetujui
Pilih API ini saat aplikasi Anda menggunakan format pesan teks Respons. Sertakan percakapan pada setiap permintaan; respons tidak disimpan untuk pengambilan di kemudian hari.
Kirim permintaan#
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());
Bidang permintaan#
| Bidang | Nilai |
|---|---|
model | Model chat yang tersedia dan diizinkan oleh kredensial Anda. |
input | String tidak kosong, atau hingga 256 pesan teks. |
instructions | Instruksi sistem opsional yang ditambahkan di awal percakapan. |
store | false; penyimpanan respons tidak didukung. |
stream | false untuk JSON atau true untuk event SSE Respons. |
Lanjutkan percakapan#
Kirim pesan sebelumnya di input bersama pesan pengguna berikutnya. Peran yang didukung adalah user, assistant, system dan developer. Instruksi pengembang menggunakan peran sistem secara internal. Konten pesan dapat berupa teks atau input_text/output_text bagian.
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
}
Baca hasilnya#
Respons JSON adalah response objek. Baca teks asisten dari output[].content[] entri dengan tipe output_text. Periksa status respons: completed adalah respons selesai; incomplete dapat menunjukkan batas token. Publik usage saat ini null; gunakan Konsol Penggunaan untuk memeriksa penggunaan yang diproses.
Streaming respons#
Atur stream: true dan parsing SSE. Event mencakup response.created, response.output_text.delta dan terminal response.completed, response.incomplete atau response.failed. Tambahkan delta teks secara berurutan dan tangani status terminal secara eksplisit.
Subset yang didukung#
Endpoint ini mendukung pembuatan teks. Respons yang disimpan, previous_response_id, pengambilan/penghapusan, alat, input gambar, permintaan latar belakang, dan pengaturan pembuatan seperti temperature tidak didukung dan ditolak. Untuk pengaturan pembuatan berbasis pesan yang didukung oleh Chat Completions, gunakan Penyelesaian Obrolan.
Gunakan token akses OAuth#
Ganti kunci API di header Authorization dengan token akses OAuth yang disetujui. surcharge cakupan dan rencana penggunaan yang diterima diperlukan untuk inferensi yang didanai akun. Cakupan identitas saja tidak mengizinkan pengeluaran. Lihat cakupan dan izin.
Terakhir diperbarui 15 September 2026