Tạo một hoàn thành hội thoại
Gửi yêu cầu hoàn thành trò chuyện ShareAI với khóa API Bearer và hiểu các mô hình được hỗ trợ, tin nhắn và trường luồng.
Trên trang này
https://api.shareai.now/api/v1/chat/completionsThực hiện một yêu cầu trò chuyện bằng mô hình đã chọn.
- URL cơ sở
https://api.shareai.now- Xác thực
- Khóa API Bearer
Đây là đường dẫn tích hợp mặc định cho các yêu cầu được thanh toán và ủy quyền bởi không gian làm việc khóa API của bạn. Các hạn chế về mô hình và nhà cung cấp của khóa áp dụng cho việc phân bổ, bao gồm các đường dẫn dự phòng được phép.
Nội dung yêu cầu#
| Trường | Loại | Ý nghĩa |
|---|---|---|
model | chuỗi, bắt buộc | Mã định danh mô hình có sẵn chính xác. Sao chép từ Models. |
messages | mảng | Tin nhắn trò chuyện chứa vai trò và nội dung. |
stream | boolean | false trả về một kết quả JSON; true yêu cầu các sự kiện được gửi từ máy chủ. |
Sử dụng nội dung tin nhắn văn bản. Gửi các vai trò như system, user và assistant phù hợp với cuộc trò chuyện. Bao gồm lịch sử cuộc trò chuyện bạn muốn mô hình sử dụng; không giả định rằng các yêu cầu chia sẻ một cuộc trò chuyện đã lưu trữ.
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/chat/completions" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "MODEL_IDENTIFIER",
"messages": [
{
"role": "system",
"content": "Be concise and helpful."
},
{
"role": "user",
"content": "Give me three ideas for a local community event."
}
],
"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': 'MODEL_IDENTIFIER', 'messages': [{'role': 'system', 'content': 'Be concise and helpful.'}, {'role': 'user', 'content': 'Give me three ideas for a local community event.'}], 'stream': False}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/chat/completions', 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/chat/completions";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "MODEL_IDENTIFIER",
"messages": [
{
"role": "system",
"content": "Be concise and helpful."
},
{
"role": "user",
"content": "Give me three ideas for a local community event."
}
],
"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());
Phản hồi#
Một kết quả hoàn thành không phát trực tuyến đặt done thành true và trả về văn bản được tạo tại message.content. Cấp cao nhất cũng mang done_reason và consumption_type. Phát trực tuyến sử dụng một định dạng khác, chat-completion-chunk. Không giả định rằng kết quả không phát trực tuyến có một mảng lựa chọn kiểu OpenAI.
JSON
{
"done": true,
"done_reason": "stop",
"consumption_type": "credits",
"message": {
"role": "assistant",
"content": "Here are three ideas for your community event.",
"done": true,
"done_reason": "stop"
}
}
Đây là một kết quả hoàn thành minh họa; consumption_type mô tả chế độ phân bổ thực tế. Kiểm tra lỗi cấp cao nhất ngay cả khi trạng thái HTTP là 200. Một kết quả không có thiết bị hiện sử dụng error.code = no_device với HTTP 200.
Hạn chế mô hình và nhà cung cấp#
Một khóa có thể bị giới hạn đối với các mô hình và nhà cung cấp thực thi cụ thể. Nếu quyền truy cập bị từ chối, hãy kiểm tra thông tin khóa và cập nhật khóa trong Console chỉ khi không gian làm việc sở hữu dự định cấp quyền truy cập đó.
Phát trực tuyến hoặc ủy quyền khách hàng#
Phát trực tuyến một phản hồi · Sử dụng một mã thông báo truy cập OAuth
Cập nhật lần cuối Tháng 9 15, 2026