KO ▾
API 키 받기

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'

유용한 결과가 없으면 발생 빈도 순으로 아래 목록을 따라가세요:

  1. 변수가 비어 있습니다. 전체 키를 출력하지 않고 첫 문자 몇 개를 확인하려면 echo "${UF_KEY:0:6}"를 실행하세요.
  2. 헤더 철자가 잘못되었거나 키 앞에 "Bearer"가 누락되었습니다.
  3. 문서나 채팅 클라이언트의 곡선(스마트) 따옴표가 명령어의 직선 따옴표를 대체했습니다.
  4. Base URL이 잘못되었습니다. https://api.unfilteredaimodels.com/v1이며, 앞에 api.이 있고 끝에 /v1이 있습니다.
  5. 키를 복사할 때 뒤에 공백이나 줄바꿈이 포함되었습니다.

응답 헤더 읽기

출력에 헤더를 포함하려면 -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 명령어를 사용할 수 있습니다.