첫 번째 API 요청 만들기
ShareAI API 키를 생성하고, 사용 가능한 모델을 선택한 후 Bearer 인증을 사용하여 서버에서 채팅 요청을 보내세요.
이 페이지에서
애플리케이션이 자체 ShareAI 작업 공간에서 API 키를 사용하여 요청을 보낼 때 여기에서 시작하세요. ShareAI 계정, 활성 키 및 실행하려는 모델에 대한 액세스가 필요합니다.
1. API 키 생성#
열기 ShareAI 콘솔 키와 사용을 소유할 작업 공간을 선택하세요. 열기 API 키, 선택하고 API 키 생성, 키에 인식 가능한 이름을 지정하고 서버 환경에 비밀을 저장하세요.


2. 모델 선택#
열기 모델 그리고 거기에 표시된 정확한 모델 식별자를 복사하세요. 현재 사용 가능 여부와 키에 대한 모델/제공자 제한을 확인하세요. 오래된 튜토리얼에 있는 식별자는 오늘날 용량이 사용 가능하다는 것을 보장하지 않습니다.
3. 요청 보내기#
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 | 키, 작업 공간 및 Authorization 헤더를 확인하세요. |
| 402 | 사용 가능한 크레딧 또는 적용 가능한 잔액을 확인하세요. |
| 403 | 허용된 모델과 제공자를 확인하세요. |
| 429 | Retry-After가 표시되면 기다렸다가 제한된 지연 시간으로 다시 시도하세요. |
| 503 | 현재 용량 또는 서비스 가용성을 확인하세요; 재시도 제한을 유지하세요. |
다음 단계#
채팅 요청 및 응답 참조 지원되는 본문을 설명합니다. 각 고객이 자신의 계정을 인증해야 하는 경우, 다음을 따르세요. 애플리케이션 OAuth.
마지막 업데이트 9월 15, 2026