ShareAI Platform Docs

创建文本响应

使用 ShareAI 响应 API 进行无状态文本生成、显式对话历史记录和响应流事件。

查看为Markdown格式
本页面内容
POST 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
}'

请求字段#

字段价值
model一个由您的凭证允许的可用聊天模型。
input一个非空字符串,或最多 256 条文本消息。
instructions可选的系统指令添加到对话之前。
storefalse;不支持存储响应。
streamfalse 用于 JSON 或 true 用于响应 SSE 事件。

继续对话#

input 中发送较早的消息以及下一条用户消息。支持的角色是 user, assistant, systemdeveloper。开发者指令在内部使用系统角色。消息内容可以是文本或 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.incompleteresponse.failed。按顺序追加文本增量并明确处理终端状态。

支持的子集#

此端点支持文本生成。存储的响应、 previous_response_id、检索/删除、工具、图像输入、后台请求和生成设置如 temperature 不支持并被拒绝。对于由 Chat Completions 支持的基于消息的生成设置,请使用 聊天完成.

使用 OAuth 访问令牌#

将 Authorization 头中的 API 密钥替换为已批准的 OAuth 访问令牌。 surcharge 账户资助的推理需要范围和接受的使用计划。仅身份范围无法授权支出。请参阅 范围和权限.

最近更新于 9 月 15, 2026

ShareAI平台文档
所有文档

按标题或内容搜索。

询问关于此页面的问题

选择一个助手来探索此页面。您也可以复制页面并将其粘贴到您的对话中。

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI