셸을 설정하고 엔드포인트를 확인하세요
API 키 페이지에서 키를 가져온 후, 매번 비밀 키를 입력하지 않도록 기본 URL과 함께 환경 변수로 내보냅니다.
export API_KEY="paste-your-key-here"
export BASE="https://api.uncensoredllmapi.com/v1"
모든 요청은 Authorization 헤더에 베어러 토큰으로 키를 보냅니다. 요청 본문은 JSON이므로 POST 시 Content-Type: application/json을 추가하세요. 최대 본문 크기는 8 MB이며, 프롬프트에 매우 큰 문서를 붙여넣는 경우에만 의미가 있습니다.
예제에서는 유닉스 셸의 작은 따옴표를 사용합니다. Windows PowerShell에서는 따옴표 문제를 피하기 위해 JSON을 파일에 넣고 --data @body.json로 전달하세요.
가장 저렴한 기본 검증은 모델을 나열하는 GET 요청입니다. 이 요청은 키와 URL을 확인하며 비용이 들지 않습니다.
curl -s "$BASE/models" \
-H "Authorization: Bearer $API_KEY"
응답의 data 배열에는 ID uncensored이 포함되어야 합니다. 401은 키가 누락되었거나 오타가 있음을 의미합니다. curl이 전혀 연결되지 않는 경우 $BASE의 호스트를 확인하고 /v1로 끝나고 추가 경로가 없도록 하세요.
1. 채팅 생성 보내기
이것은 모든 OpenAI 스타일 클라이언트가 내부적으로 보내는 요청입니다.
curl -s "https://api.uncensoredllmapi.com/v1/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Give me three names for a fantasy tavern."}
],
"temperature": 0.8,
"max_tokens": 200
}'
응답은 JSON 형식입니다. 텍스트는 choices[0].message.content에 위치하며, 토큰 사용량은 usage에 있습니다. jq가 설치되어 있고 텍스트만 필요하면 출력을 jq -r '.choices[0].message.content'에 전달하세요. max_tokens 필드는 선택사항입니다. 이 필드를 생략하면 완료 생성이 100,000개 토큰 컨텍스트 창에 남은 만큼을 사용할 수 있습니다.
클라이언트가 해당 형식을 사용하는 경우 새로운 POST /v1/responses 엔드포인트도 사용할 수 있습니다. 매개변수 전체 목록은 문서를 참조하세요.
2. 답변 스트리밍
"stream": true를 추가하고 -N으로 curl이 버퍼링하지 않도록 하세요. 생성되는 대로 토큰이 출력됩니다.
curl -N "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"stream": true,
"messages": [{"role": "user", "content": "Count from one to ten in words."}]
}'
각 줄은 data:로 시작하며 delta가 포함된 작은 JSON 청크를 포함합니다. 마지막 이벤트에는 사용량이 포함되고 스트림은 data: [DONE]로 종료됩니다. -N 없이 curl은 전체 버퍼를 기다리며 출력이 한 덩어리로 도착하는 것처럼 보입니다. 스트리밍 요청은 종료될 때까지 하나의 동시성 슬롯을 점유합니다.
3. JSON 형식 요청
스크립트가 구문 분석할 출력의 경우 response_format으로 JSON 모드를 활성화하세요. 프롬프트에 JSON이라는 단어를 언급하여 모델이 기대하는 형식을 알리세요.
curl -s "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [{"role": "user",
"content": "Return JSON with keys name and level for a fantasy character."}]
}' | jq -r '.choices[0].message.content | fromjson'
최종 fromjson 필터는 content 내부의 문자열을 구문 분석하므로 모델이 유효한 JSON이 아닌 것을 반환한 경우 jq가 명확하게 실패합니다. 이는 편리한 빠른 테스트가 됩니다. 더 많은 패턴은 JSON 모드 페이지에 있습니다.
4. 도구 호출 시도
함수 호출은 모델이 코드에서 함수를 실행하도록 요청할 수 있게 합니다. 함수를 tools 배열로 설명하고, 모델이 이를 사용하기로 결정하면 응답에 텍스트 대신 tool_calls 항목이 포함됩니다.
curl -s "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the weather in Oslo?"}],
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}],
"tool_choice": "auto"
}' | jq '.choices[0].message.tool_calls'
함수 이름과 인수의 JSON 문자열을 얻어야 합니다. 코드에서 함수를 실행한 후, 이전 메시지를 반복하고 도구 호출이 포함된 어시스턴트 메시지를 추가하며, 결과를 포함하는 role: "tool" 메시지로 두 번째 요청을 보냅니다. 그런 다음 모델이 최종 답변을 작성합니다.
5. 헤더 및 잔액 확인
-i를 추가하여 본문과 함께 응답 헤더를 확인하세요. X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests 및 X-RateLimit-Limit-Concurrency을 찾을 수 있습니다.
curl -s -i "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}' \
| grep -i "^x-"
curl -s "$BASE/balance" -H "Authorization: Bearer $API_KEY"
두 번째 호출이 크레딧을 직접 반환합니다. OpenAI 스타일의 도구는 GET /v1/dashboard/billing/credit_grants를 대신 사용할 수 있습니다. 위의 작은 요청은 센의 일부 비용이 듭니다: 입력 토큰 10개와 출력 토큰 5개의 경우 가격은 10 x 0.15 / 1,000,000 + 5 x 0.50 / 1,000,000 = $0.000004입니다. 자세한 요금은 가격 책정 페이지를 참조하세요.
재사용 가능한 스모크 테스트 스크립트
개별 호출을 신뢰하면 배포, 키 회전 또는 네트워크 변경 후 실행할 수 있는 짧은 스크립트로 래핑하세요. 첫 번째 문제에서 실패하므로 어떤 단계가 깨졌는지 정확히 알 수 있습니다.
set -euo pipefail
BASE="https://api.uncensoredllmapi.com/v1"
echo "models:"
curl -sf "$BASE/models" -H "Authorization: Bearer $API_KEY" | jq -r '.data[].id'
echo "chat:"
curl -sf "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ok."}],"max_tokens":5}' \
| jq -r '.choices[0].message.content'
echo "balance:"
curl -sf "$BASE/balance" -H "Authorization: Bearer $API_KEY"
-f 플래그는 HTTP 실패 시 curl이 오류로 종료되게 하고, set -e은 스크립트를 그곳에서 중단합니다. 이 API 위에 서비스를 실행하고 변경 사항이 발생하면 조기 경고를 원한다면 크론 작업이나 CI 단계에 넣으세요. 키를 비밀 저장소 또는 환경 변수에 보관하고, 스크립트 파일 자체에는 저장하지 마세요.
요청을 변경할 때 한 번에 하나의 설정을 시도하세요: temperature는 무작위성, top_p은 뉴클레어스 샘플링, stop은 사용자 정의 종료 시퀀스, seed은 반복 가능한 출력용입니다. 모두 모델로 전달되므로 동일한 터미널 기록에서 효과를 비교할 수 있습니다.
curl 오류 읽기
| 상태 | 잠재적 원인 | 해결 방법 |
|---|---|---|
| 401 | 누락 또는 잘못된 키 | Authorization 헤더를 확인하고 $API_KEY이 내보내졌는지 확인하세요 |
| 400 | 잘못된 JSON 또는 잘못된 필드 | 보내기 전에 jq .로 본문을 검증하세요 |
429, 코드 rate_limited | 분당 300개 이상의 요청 (시험 키의 경우 60개) | 루프를 늦추세요 |
429, 코드 concurrency | 동시에 8개 이상의 요청 (체험 키의 경우 2개) | 더 적은 병렬 작업 실행 |
429 및 Retry-After: 5 | 일시적 과부하 | 5초 대기 후 재시도 |
-w "\n%{http_code}\n"을 추가하여 본문 뒤에 상태 코드를 인쇄하여 추측하지 않도록 하세요. 오류 본문은 메시지와 코드를 포함하는 JSON이므로 jq .error이 명확하게 표시합니다. 루프에서 429을 보면 즉시 다시 시도하지 마세요. 몇 초의 지연은 분 창과 동시성 슬롯을 비우게 하며, 촘촘한 재시도 루프는 한도 초과 상태만 유지시킵니다. 시험 키는 전체 키보다 제한이 더 엄격하므로 첫 번째 충전 후 스크립트가 작동하더라도 병렬로 작업을 실행하는 경우 시험 크레딧에서 실패할 수 있습니다. 요청이 정상적으로 작동하면 SDK로 이동하세요. 동일한 URL과 모델 이름은 변경되지 않고 이어집니다. 새 계정은 한 번의 클릭으로 $0.50의 시험 크레딧을 청구할 수 있으며, 이는 수백 번의 작은 테스트 호출에 충분합니다. 이후 충전은 $20부터 시작하며 암호화폐(TRC20의 USDT 또는 Base의 USDC)로 지불됩니다.
