API 퀸 API 문서

Base URL 및 인증

인증은 표준 Bearer 토큰을 헤더에 전달하여 수행합니다. Authorization 이 접근 방식은 사용자 정의 로직 없이 기존 OpenAI SDK와의 호환성을 보장합니다. 귀하의 API_KEY 가입 시 Google 또는 이메일을 통해 즉시 생성됩니다. 모든 요청은 서비스 제공 전용 베이스 URL로 향해야 합니다.

• Base URL: https://api.apiqueen.cc/v1
• 헤더: Authorization: Bearer API_KEY

Copycurl https://api.apiqueen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return current status for service api queen"}]
  }'

/v1/chat/completions으로 요청 전송

엔드포인트에 텍스트 데이터를 보내 직접 모델 응답을 받으세요. 모델 ID는 항상 uncensored, 표준 거부 없이 다양한 주제를 처리합니다. 매개변수를 다음과 같이 지정할 수 있습니다. temperature 및 top_p 창의성을 제어합니다. 시스템은 표준 채팅 형식의 메시지 목록을 기대합니다.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apiqueen.cc/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apiqueen.cc/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

모델 매개변수: Temperature, Top-P 및 Stop

표준 LLM 매개변수를 사용하여 응답 생성을 제어하세요. 설정 temperature 0과 2 사이에서 다양하게 조정하여 무작위성을 조절하세요. 사용 top_p 확률이 낮은 단어를 필터링합니다. stop 특정 트리거에서 출력을 중단하기 위한 시퀀스. 이러한 설정은 창의적 글쓰기 또는 사실적 검색 작업에 정밀한 튜닝을 허용합니다.

API는 지원되지 않는 매개변수를 우아하게 무시합니다. 에 집중하세요 temperature, top_p, 그리고 stop 최적의 결과를 위해. 이러한 값은 애플리케이션의 노이즈 허용도에 따라 조정하십시오.

스트리밍 응답 및 토큰 사용량

stream을 true로 설정하여 스트리밍 활성화 stream: true 요청에 포함됩니다. API는 서버 전송 이벤트(SSE)를 통해 데이터 청크를 반환합니다. 토큰 사용량 세부 정보는 스트림의 마지막 청크에만 나타납니다. 이를 통해 UI에서 응답을 실시간으로 렌더링할 수 있습니다.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

부분 응답을 신중하게 처리하세요. 클라이언트는 스트림이 종료될 때까지 데이터를 버퍼링해야 합니다.

함수 호출 및 JSON 모드

구조화된 데이터 추출을 위해 함수 호출을 사용하세요. 요청에 도구를 정의하세요. tools 파라미터. 모델은 response_format 설정됨 {"type": "json_object"}. 이는 하류 애플리케이션에서의 일관된 파싱을 보장합니다.

設定 tool_choice 특정 함수 호출을 강제합니다. 이는 엄격한 출력 형식이 필요한 자동화 워크플로우에 유용합니다.

오류 처리 및 속도 제한

공통 문제를 위해 HTTP 상태 코드를 모니터링합니다. 401 오류는 API 키가 유효하지 않음을 의미합니다. 402 오류는 사전 지불 크레딧이 부족함을 나타냅니다. 오류는 토큰 잔액을 소모하지 않습니다. 속도 제한은 키당 분당 300개의 요청을 강제합니다. 동시 요청은 8개로 제한됩니다. 컨텍스트 창은 총 100,000개의 토큰을 지원합니다.

지수 백오프로 재시도를 처리하세요. error JSON 응답의 object에서 세부 정보를 확인하세요.