发起您的第一个 API 请求
创建一个ShareAI API密钥,选择一个可用模型,并从您的服务器发送带有Bearer认证的聊天请求。
本页面内容
当您的应用程序将使用来自您自己的ShareAI工作区的API密钥发出请求时,从这里开始。您需要一个ShareAI账户、一个有效的密钥以及对您想运行的模型的访问权限。
1. 创建API密钥#
打开 ShareAI控制台 并选择将拥有密钥和使用权的工作区。打开 API 密钥, 中,选择 创建 API 密钥,给密钥一个易于识别的名称,并将密钥保存在您的服务器环境中。


2. 选择模型#
打开 模型 并复制那里显示的确切模型标识符。检查当前可用性以及密钥上的模型/提供者限制。旧教程中的标识符不能保证今天仍有容量可用。
3. 发送请求#
POST
https://api.shareai.now/api/v1/chat/completions使用可用模型生成响应。
- 基础 URL
https://api.shareai.now- 身份验证
- Bearer API 密钥
替换 MODEL_IDENTIFIER 使用您选择的标识符。设置 SHAREAI_API_KEY 在运行示例之前在您的环境中。
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": "user",
"content": "Explain what ShareAI does in one sentence."
}
],
"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': 'user', 'content': 'Explain what ShareAI does in one sentence.'}], '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": "user",
"content": "Explain what ShareAI does in one sentence."
}
],
"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());
4. 阅读结果#
对于成功的非流式请求,请检查done是否为true,并从中读取助手消息 message.content。在将其视为成功完成之前,请检查HTTP状态和正文中的任何错误对象。目前,无设备结果可能作为带有HTTP 200的错误对象到达。
如果请求失败#
| 状态 | 下一步 |
|---|---|
| 401 | 检查密钥、工作区和授权头。 |
| 402 | 检查可用积分或适用余额。 |
| 403 | 检查允许的模型和提供者。 |
| 429 | 当出现Retry-After时等待,然后以有限的延迟重试。 |
| 503 | 检查当前容量或服务可用性;保持重试限制。 |
下一步#
最近更新于 9 月 15, 2026