cURL과 Bearer 토큰으로 사용하는 OpenAI 스타일 API
명령줄에서 OpenAI 스타일 API를 호출하려면 토큰이 포함된 Authorization 헤더와 함께 HTTP POST를 전송해야 합니다. 이 페이지는 이 API의 모든 기능에 대한 작동하는 cURL 명령어와 실패 시 확인 방법을 제공합니다.
업데이트

주요 포인트
- 토큰은 Authorization: Bearer YOUR_KEY 헤더에 포함되며, 모델 ID는 uncensored입니다.
- 두 가지 엔드포인트가 있습니다: GET /v1/models와 POST /v1/chat/completions.
- 스트리밍을 위해 -N과 stream true를 추가하여 서버 전송 이벤트를 통해 토큰이 도착하는 것을 확인하세요.
- curl -i로 X-Balance-USD 및 속도 제한 헤더를 읽으세요; 429은 대기 후 재시도를 의미합니다.
최소 요청
이 서비스에 open ai api curl with token을 사용하는 가장 짧은 방법입니다. 키를 환경 변수에 저장하여 셸 히스토리에 남지 않게 한 후 채팅 메시지를 전송하세요:
export UF_KEY="paste-your-key-here"
curl https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Explain what a bearer token is in two sentences."}
]
}'
응답은 OpenAI 채팅 완료 형식의 JSON입니다. 답변은 choices[0].message.content에 있으며, usage 객체는 프롬프트 및 완료 토큰을 보고합니다. 명령어의 각 부분은 다음과 같은 역할을 합니다:
Authorization: Bearer ...는 토큰을 전달합니다. "Bearer"는 스키마 이름이며, 토큰을 가진 사람이 소유자로 간주되므로 공개 저장소에 키를 두지 않는 이유입니다.Content-Type: application/json는 서버가 본문을 읽는 방법을 알려줍니다. 없으면 요청이 본문 구문 분석 오류로 실패할 수 있습니다.model은 이 API가 제공하는 유일한 모델인uncensored여야 합니다.messages는role(system, user, assistant 또는 tool)과content을 가진 객체 목록입니다.
키를 얻으려면 Google 또는 이메일과 비밀번호로 가입한 후 API 키 페이지를 사용하세요. 신규 사용자는 한 번의 클릭으로 무료 체험 크레딧 $0.50을 청구할 수 있습니다: 카드 불필요, 7일 유효, 인원당 1회.
GET /v1/models로 키를 확인하세요.
긴 요청을 디버깅하기 전에 가장 저렴한 호출로 토큰이 작동하는지 확인하세요. 모델 목록 조회는 비용이 없으며 URL, 헤더 및 키가 모두 올바른지 보여줍니다.
curl -s https://api.unfilteredaimodels.com/v1/models \
-H "Authorization: Bearer $UF_KEY"
좋은 답변은 uncensored를 포함하는 JSON 목록입니다. jq이 설치되어 있으면 파이프라인을 통해 ID만 추출하세요:
curl -s https://api.unfilteredaimodels.com/v1/models \
-H "Authorization: Bearer $UF_KEY" | jq -r '.data[].id'
유용한 결과가 없으면 발생 빈도 순으로 아래 목록을 따라가세요:
- 변수가 비어 있습니다. 전체 키를 출력하지 않고 첫 문자 몇 개를 확인하려면
echo "${UF_KEY:0:6}"를 실행하세요. - 헤더 철자가 잘못되었거나 키 앞에 "Bearer"가 누락되었습니다.
- 문서나 채팅 클라이언트의 곡선(스마트) 따옴표가 명령어의 직선 따옴표를 대체했습니다.
- Base URL이 잘못되었습니다.
https://api.unfilteredaimodels.com/v1이며, 앞에api.이 있고 끝에/v1이 있습니다. - 키를 복사할 때 뒤에 공백이나 줄바꿈이 포함되었습니다.
응답 헤더 읽기
출력에 헤더를 포함하려면 -i를 추가하거나, 본문을 깔끔하게 유지하면서 출력하려면 -D -를 사용하세요:
curl -s -D - -o /dev/null \
https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"ping"}]}'
알아두면 유용한 네 가지 응답 헤더:
| 헤더 | 의미 |
|---|---|
X-Request-Id | 이 요청의 식별자입니다. 지원팀에 문의할 때 인용하세요. |
X-Balance-USD | 남은 선불 크레딧. |
X-RateLimit-Limit-Requests | 키당 분당 허용된 요청 수. |
X-RateLimit-Limit-Concurrency | 키당 허용된 동시 요청 수. |
전체 키의 경우 분당 300회 요청, 동시 8개 요청이 제한이며, 체험용 키는 분당 60회, 동시 2개 요청이 제한입니다. 위의 요청은 테스트 크기를 작게 유지하기 위해 max_tokens을 5로 설정합니다. 일반적인 사용 시 max_tokens은 선택 사항이며, 생성 결과는 프롬프트 이후의 100,000개 토큰 창에 남은 만큼을 사용할 수 있습니다.
명령줄에서 스트리밍하기
"stream": true를 설정하고 -N을 추가하여 curl이 출력을 버퍼링하지 않도록 합니다. data:로 시작하는 줄들이 표시되며, 각 줄에는 작은 JSON 델타가 포함됩니다. 마지막에는 data: [DONE]이 표시되며, 그 이전의 청크에는 토큰 사용량이 포함됩니다.
curl -N https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"stream": true,
"messages": [{"role": "user", "content": "Write a four-line poem about a cron job."}]
}'
텍스트만 출력하려면 스트림을 짧은 파이프라인으로 필터링하세요:
curl -sN https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","stream":true,"messages":[{"role":"user","content":"Count to five."}]}' \
| sed -u 's/^data: //' | grep -v '^\[DONE\]' | grep -v '^$' \
| jq -rj '.choices[0].delta.content // empty'
echo
스트리밍 요청은 스트림이 끝날 때까지 동시 요청 슬롯을 유지합니다. 스크립트에서 많은 스트림을 병렬로 시작하고 완료하지 않으면 요청 속도가 낮더라도 동시 제한에 도달합니다.
JSON 모드 및 도구 호출
JSON 모드는 모델이 유효한 JSON 객체 하나를 반환하도록 합니다. 원하는 형태를 프롬프트에 또한 명시하세요. 그렇지 않으면 키가 모델이 선택한 값이 됩니다.
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "user", "content": "Return JSON with keys city and country for the capital of Portugal."}
]
}' | jq -r '.choices[0].message.content'
도구 호출은 표준 tools 및 tool_choice 필드를 사용합니다. 모델은 텍스트 대신 tool_calls 배열로 응답합니다. 함수를 직접 실행하고 결과를 role: "tool" 및 일치하는 tool_call_id과 함께 메시지 형태로 다시 전송합니다.
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"tool_choice": "auto",
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}],
"messages": [{"role": "user", "content": "What is the weather in Lisbon?"}]
}'
응답에서 choices[0].message.tool_calls[0].function.arguments를 확인하세요. 이는 JSON 문자열로, 구문 분석 후 자신의 날씨 함수를 호출하고 다음 요청에서 반환합니다. temperature, top_p, stop, seed 및 페널티와 같은 매개변수가 전달됩니다. 문서은 지원되는 모든 필드를 나열합니다.
토큰을 안전하게 보관하고 명령어를 깔끔하게 유지하세요
Bearer 토큰은 이름이 다른 비밀번호입니다. 이를 가진 사람은 크레딧을 사용할 수 있으므로 주의해야 합니다. 실제 키를 공개 이슈, 스크린샷 또는 공유 터미널 로그에 붙여넣지 마세요. 키가 유출된 것으로 의심되면 키 페이지에서 교체하고 스크립트를 업데이트하세요.
셸 히스토리는 개인 기기에서 가장 흔한 유출 경로입니다. 키를 명령어에 직접 입력하면 히스토리 파일에 저장됩니다. export로 한 번 설정해도 해당 줄이 저장됩니다. 더 깔끔한 두 가지 습관이 도움이 됩니다. 당신만 열 수 있는 파일에서 키를 읽거나, 셸이 공백으로 시작하는 줄을 무시하도록 설정된 경우 명령어 앞에 공백을 붙이세요. 작은 파일이 잘 작동합니다:
mkdir -p ~/.config/uf
printf '%s' 'paste-your-key-here' > ~/.config/uf/key
chmod 600 ~/.config/uf/key
export UF_KEY="$(cat ~/.config/uf/key)"
긴 JSON 본문은 작은따옴표 안에 읽기 어렵고, 프롬프트 자체에 아포스트로피가 있으면 인용이 깨집니다. 본문을 파일에 넣고 curl이 -d @file로 읽게 하세요:
cat > request.json <<'JSON'
{
"model": "uncensored",
"temperature": 0.3,
"messages": [
{"role": "system", "content": "You answer in plain language."},
{"role": "user", "content": "What's the difference between a 401 and a 403 status code?"}
]
}
JSON
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d @request.json | jq -r '.choices[0].message.content'
이 접근 방식은 8 MB 본문 제한 내의 큰 프롬프트를 관리 가능하게 유지하고, 파일은 git에서 버전 관리할 수 있지만 키는 저장소 외부에 유지됩니다. Windows PowerShell에서는 JSON 주변의 작은따옴표가 다르게 동작하고 역슬래시 줄 계속하기 기능이 없으므로, -d @request.json 형식은 두 문제 모두 피할 수 있으며, 줄 끝에 백틱을 사용하여 명령을 계속할 수 있습니다.
테스트가 끝나면 SDK로 이동하세요. OpenAI Python 및 Node 라이브러리는 동일한 Base URL과 키를 받아들이며, 재시도 및 스트리밍을 처리하고 여기에서 수동으로 구문 분석하던 동일한 응답 형식을 읽습니다. cURL 명령어는 실패가 코드에서 비롯된 것인지 요청 자체에서 비롯된 것인지 확인하는 가장 빠른 방법이므로 메모장에 잘 알려진 명령어를 보관하세요. 지원팀에 문제를 보고할 때는 실패한 호출의 X-Request-Id와 정확한 상태 코드를 포함하세요. 이 쌍은 테스트를 반복하지 않고도 요청을 찾을 수 있게 하여 왕복 시간을 절약합니다.
오류, 재시도 및 호출당 비용
한도를 초과하면 API는 HTTP 429로 응답합니다. 오류 코드는 어떤 한도를 초과했는지 알려줍니다: rate_limited은 분당 요청 수가 많음을, concurrency은 동시 요청 수가 많음을 의미합니다. 일시적인 과부하도 429를 반환하고 Retry-After: 5를 추가합니다. curl은 일시적 오류에 대해 자체적으로 재시도할 수 있습니다:
curl --retry 3 --retry-delay 5 --retry-all-errors \
https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'
또한 본문 크기를 8 MB 이하로 유지하세요. 이는 프롬프트에 인코딩된 파일을 게시하는 경우 중요합니다.
실패하거나 거부된 요청은 요금이 부과되지 않습니다. 성공한 요청은 간단한 공식을 따릅니다: 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50. 입력 토큰 40개와 출력 토큰 120개로 테스트 호출하면 40 / 1,000,000 x $0.15 = $0.000006 + 120 / 1,000,000 x $0.50 = $0.00006이므로 총 $0.000066이 듭니다. 1000번이면 $0.066입니다.
크레딧은 선불이며 만료되지 않습니다. 충전은 $20부터 $500까지 정수 금액으로 진행되며, $50부터 5%, $100부터 10%, $200부터 15% 보너스가 제공됩니다. 결제는 암호화폐(TRC20 USDT, Base USDC)로 가능합니다. 가격 페이지에 세부 정보가 나와 있습니다. 응답이 이상해 보이면 오해와 사실 페이지에서 모델이 무엇을 하고 무엇을 하지 않는지 설명합니다.
더 많은 가이드
질문과 답변
키는 양식 하나만 작성하면 받을 수 있습니다
계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것으로 끝입니다.
cURL 명령어에서 토큰은 어디에 넣나요?
- 헤더에 넣습니다: -H "Authorization: Bearer YOUR_KEY". 요청 본문에도 Content-Type: application/json 헤더가 필요합니다.
어떤 모델 이름을 사용해야 하나요?
- uncensored 모델을 사용하세요. GET /v1/models로 확인할 수 있습니다.
429 오류가 발생하는 이유는 무엇인가요?
- 한도를 초과했습니다. rate_limited 코드는 분당 요청 수가 많음을, concurrency 코드는 동시 요청 수가 많음을 의미합니다. 몇 초간 기다리거나 동시 호출 수를 줄이세요.
잔여 크레딧은 어떻게 확인하나요?
- 모든 응답에는 X-Balance-USD 헤더가 포함됩니다. curl -i 또는 curl -D -로 헤더를 출력하세요.
이것이 공식 OpenAI API인가요?
- 아니요. 이 서비스는 독립적인 OpenAI 호환 서비스로 단일 오픈 웨이트 모델을 실행하므로, Base URL과 API 키를 변경한 후 OpenAI 형식을 위한 SDK와 cURL 명령어를 사용할 수 있습니다.