テキスト応答を作成
ShareAI Responses APIを使用して、ステートレスなテキスト生成、明示的な会話履歴、およびResponsesストリーミングイベントを実現します。
このページについて
https://api.shareai.now/api/v1/responsesプロンプトまたは会話からテキスト応答を生成します。
- ベースURL
https://api.shareai.now- 認証
- Bearer APIキーまたは承認済みOAuthアクセストークン
アプリケーションがResponsesテキストメッセージ形式を使用する場合、この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 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がサポートするメッセージベースの生成設定については、 チャット完了.
ストリーミングまたは顧客認証#
AuthorizationヘッダーのAPIキーを承認済みのOAuthアクセストークンに置き換えてください。 surcharge スコープと承認された使用プランがアカウント資金による推論に必要です。アイデンティティ専用スコープでは支出を承認しません。詳細は スコープと権限.
最終更新日 2026年9月15日