建立文字回應
使用 ShareAI 回應 API 嚟進行無狀態文本生成、明確嘅對話歷史同回應流事件。
喺呢頁面
https://api.shareai.now/api/v1/responses從提示或者對話生成文本回應。
- 基礎 URL
https://api.shareai.now- 認證
- Bearer API 密鑰或者已批准嘅 OAuth 訪問權杖
當你嘅應用程序使用回應文本消息格式時,揀呢個 API。喺每次請求中提供對話;回應唔會被存儲以供後續檢索。
發送請求#
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 用於回應 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 可以表示 Token 限制。公共 usage 目前係空嘅;使用控制台使用情況嚟檢查處理過嘅使用情況。
流式傳輸回應#
設定 stream: true 同解析 SSE。事件包括 response.created, response.output_text.delta 同一個終端 response.completed, response.incomplete 或 response.failed。按順序追加文本增量,並明確處理終端狀態。
支持嘅子集#
呢個端點支持文本生成。存儲嘅回應, previous_response_id、檢索/刪除、工具、圖像輸入、背景請求同生成設置,例如 temperature 唔支援同會被拒絕。對於由 Chat Completions 支援嘅基於訊息嘅生成設置,請使用 聊天完成.
使用 OAuth 訪問令牌#
喺 Authorization 標頭入面用獲批嘅 OAuth 訪問令牌取代 API 密鑰。 surcharge 範圍同接受嘅使用計劃係賬戶資助推理所需。僅身份範圍唔授權支出。睇 範圍同權限.
最後更新日期:2026年9月15日