ShareAI Platform Docs

Tạo phản hồi văn bản

Sử dụng API Phản hồi ShareAI để tạo văn bản không trạng thái, lịch sử hội thoại rõ ràng và các sự kiện phát trực tuyến Phản hồi.

Xem dưới dạng Markdown
Trên trang này
POST https://api.shareai.now/api/v1/responses

Tạo phản hồi văn bản từ một gợi ý hoặc cuộc hội thoại.

URL cơ sở
https://api.shareai.now
Xác thực
Khóa API Bearer hoặc token truy cập OAuth đã được phê duyệt

Chọn API này khi ứng dụng của bạn sử dụng định dạng tin nhắn văn bản Phản hồi. Cung cấp cuộc hội thoại trong mỗi yêu cầu; các phản hồi không được lưu trữ để truy xuất sau.

Gửi một yêu cầu#

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
}'

Các trường yêu cầu#

TrườngGiá trị
modelMột mô hình trò chuyện khả dụng được phép bởi thông tin xác thực của bạn.
inputMột chuỗi không rỗng, hoặc tối đa 256 tin nhắn văn bản.
instructionsHướng dẫn hệ thống tùy chọn được thêm vào trước cuộc hội thoại.
storefalse; lưu trữ phản hồi không được hỗ trợ.
streamfalse cho JSON hoặc true cho các sự kiện SSE Phản hồi.

Tiếp tục một cuộc hội thoại#

Gửi các tin nhắn trước đó trong input cùng với tin nhắn tiếp theo của người dùng. Các vai trò được hỗ trợ là user, assistant, systemdeveloper. Hướng dẫn dành cho nhà phát triển sử dụng vai trò hệ thống nội bộ. Nội dung tin nhắn có thể là văn bản hoặc input_text/output_text các phần.

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
}

Đọc kết quả#

Phản hồi JSON là một response đối tượng. Đọc văn bản trợ lý từ output[].content[] các mục nhập với loại output_text. Kiểm tra trạng thái phản hồi: completed là một phản hồi đã hoàn thành; incomplete có thể chỉ ra giới hạn token. Công khai usage hiện tại là null; sử dụng Bảng điều khiển Sử dụng để kiểm tra mức sử dụng đã xử lý.

Phát trực tuyến một phản hồi#

Đặt stream: true và phân tích SSE. Các sự kiện bao gồm response.created, response.output_text.delta và một trạng thái kết thúc response.completed, response.incomplete hoặc response.failed. Nối các delta văn bản theo thứ tự và xử lý trạng thái kết thúc một cách rõ ràng.

Tập hợp con được hỗ trợ#

Điểm cuối này hỗ trợ tạo văn bản. Các phản hồi được lưu trữ, previous_response_id, truy xuất/xóa, công cụ, đầu vào hình ảnh, yêu cầu nền và cài đặt tạo như temperature không được hỗ trợ và bị từ chối. Đối với các cài đặt tạo dựa trên tin nhắn được hỗ trợ bởi Chat Completions, sử dụng Hoàn thành trò chuyện.

Sử dụng một mã thông báo truy cập OAuth#

Thay thế khóa API trong tiêu đề Authorization bằng mã truy cập OAuth đã được phê duyệt. surcharge phạm vi và kế hoạch sử dụng được chấp nhận là bắt buộc cho suy luận được tài trợ bởi tài khoản. Các phạm vi chỉ định danh không cho phép chi tiêu. Xem phạm vi và quyền.

Cập nhật lần cuối Tháng 9 15, 2026

Tài liệu Nền tảng ShareAI
Tất cả tài liệu

Tìm kiếm theo tiêu đề hoặc nội dung.

Hỏi về trang này

Chọn một trợ lý để khám phá trang này. Bạn cũng có thể sao chép trang và dán vào cuộc trò chuyện của mình.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI