สร้างการตอบกลับข้อความ
ใช้ ShareAI Responses API สำหรับการสร้างข้อความแบบไร้สถานะ ประวัติการสนทนาแบบชัดเจน และเหตุการณ์การสตรีม Responses.
ในหน้านี้
https://api.shareai.now/api/v1/responsesสร้างการตอบกลับข้อความจากพรอมต์หรือการสนทนา.
- Base URL → URL พื้นฐาน
https://api.shareai.now- การตรวจสอบสิทธิ์
- Bearer API key หรือโทเค็นการเข้าถึง OAuth ที่ได้รับการอนุมัติ
เลือก API นี้เมื่อแอปพลิเคชันของคุณใช้รูปแบบข้อความ Responses จัดหาการสนทนาในทุกคำขอ; การตอบกลับจะไม่ถูกจัดเก็บเพื่อเรียกดูในภายหลัง.
ส่งคำขอ#
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());
ฟิลด์คำขอ#
| ฟิลด์ | ค่า |
|---|---|
model | รุ่นแชทที่พร้อมใช้งานและได้รับอนุญาตจากข้อมูลรับรองของคุณ. |
input | สตริงที่ไม่ว่างเปล่าหรือข้อความสูงสุด 256 ข้อความ. |
instructions | คำแนะนำระบบที่เลือกได้ซึ่งเพิ่มไว้ก่อนการสนทนา. |
store | false; การจัดเก็บการตอบกลับไม่ได้รับการสนับสนุน. |
stream | false สำหรับ JSON หรือ true สำหรับเหตุการณ์ Responses SSE. |
ดำเนินการสนทนาต่อ#
ส่งข้อความก่อนหน้าใน input พร้อมกับข้อความผู้ใช้ถัดไป บทบาทที่รองรับคือ user, assistant, system และ developer. คำแนะนำสำหรับนักพัฒนาใช้บทบาทระบบภายใน เนื้อหาข้อความสามารถเป็นข้อความหรือ input_text/output_text ส่วนต่าง ๆ.
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
}
อ่านผลลัพธ์#
การตอบกลับ JSON คือ response วัตถุ อ่านข้อความผู้ช่วยจาก output[].content[] รายการที่มีประเภท output_text. ตรวจสอบสถานะการตอบกลับ: completed เป็นการตอบกลับที่เสร็จสิ้น; incomplete อาจบ่งชี้ถึงขีดจำกัดโทเค็น สาธารณะ usage ปัจจุบันเป็น null; ใช้การใช้งานคอนโซลเพื่อตรวจสอบการใช้งานที่ประมวลผล.
สตรีมการตอบกลับ#
ตั้งค่า stream: true และแยกวิเคราะห์ SSE เหตุการณ์รวมถึง response.created, response.output_text.delta และสถานะสุดท้าย response.completed, response.incomplete หรือ response.failed. เพิ่มเดลต้าข้อความตามลำดับและจัดการสถานะสุดท้ายอย่างชัดเจน.
ชุดย่อยที่รองรับ#
จุดสิ้นสุดนี้รองรับการสร้างข้อความ การตอบกลับที่จัดเก็บ, previous_response_id, การดึงข้อมูล/การลบ, เครื่องมือ, การป้อนภาพ, คำขอพื้นหลัง และการตั้งค่าการสร้าง เช่น temperature ไม่รองรับและถูกปฏิเสธ สำหรับการตั้งค่าการสร้างข้อความที่รองรับโดย Chat Completions ให้ใช้ การเติมเต็มการแชท.
ใช้โทเค็นการเข้าถึง OAuth#
แทนที่ API key ในส่วน Authorization header ด้วย OAuth access token ที่ได้รับการอนุมัติ surcharge ขอบเขตและแผนการใช้งานที่ได้รับการยอมรับเป็นสิ่งจำเป็นสำหรับการประมวลผล AI ที่ได้รับการสนับสนุนจากบัญชี ขอบเขตที่เกี่ยวข้องกับตัวตนเท่านั้นไม่อนุญาตให้ใช้จ่าย ดู ขอบเขตและสิทธิ์.
อัปเดตล่าสุด กันยายน 15, 2026