빠른 시작: 채팅 완료 API

필수 조건 및 베이스 URL

당사의 API는 표준 OpenAI 채팅 완료 인터페이스와 완전히 호환됩니다. 요청 전송을 시작하려면 기본 URL과 API 키만 있으면 됩니다. 기본 URL은 HTTPS://api.howmuchisanapikey.com/v1입니다. 이 단일 엔드포인트는 여러 서비스 URL이나 프록시 구성을 관리할 필요 없이 모든 텍스트 생성을 처리합니다.

인증은 직관적입니다. Bearer 스키마와 고유 키가 포함된 Authorization 헤더를 포함해야 합니다. 채팅 완료 엔드포인트로의 모든 요청에는 계정 검증 및 선불 크레딧 잔액에 대한 토큰 사용량 추적을 위해 이 헤더가 필요합니다.

인증 및 헤더

모든 요청에 Authorization 헤더를 포함하여 신원을 확인합니다. 헤더 형식은 Authorization: Bearer YOUR_API_KEY입니다. 키가 유효하지 않거나 만료된 경우 API는 즉시 401 오류를 반환합니다. 이는 사전 결제된 크레딧을 사용할 수 있는 계정이 인증된 계정임을 보장합니다.

기본 텍스트 생성에는 추가 헤더를 전달할 필요가 없습니다. 그러나 JSON 모드나 함수 호출과 같은 특정 기능을 사용하는 경우 Content-Type 헤더를 application/json으로 설정해야 합니다. 이는 서버가 요청 본문을 올바르게 구문 분석할 수 있도록 알려줍니다.

첫 채팅 완료 보내기

메시지 기록과 모델 식별자를 사용하여 /v1/chat/completions으로 POST 요청을 보내세요. 모델 id는 "uncensored"입니다. 이 모델은 합법적인 성인 콘텐츠, 픽션, 논쟁적인 주제에 대해 거부 없이 응답하도록 튜닝되었습니다. 표준 정치 또는 사회적 규범에 기반한 필터링을 수행하지 않습니다.

시작을 위한 기본 curl 예제입니다:

Copycurl https://api.howmuchisanapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a simple hello world function in python"}]
  }'

응답에는 choices 배열에 생성된 텍스트가 포함됩니다. 이를 애플리케이션 로직으로 직접 구문 분석할 수 있습니다. 각 요청은 프롬프트에 대한 입력 토큰과 모델 응답에 대한 출력 토큰을 소모합니다.

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

Server-Sent Events(SSE)를 사용하여 생성되는 대로 토큰을 받으세요. 이는 긴 출력에 대한 지각된 레이턴시를 줄입니다. 요청 본문에서 stream 매개변수를 true로 설정하세요. 서버는 응답의 부분적인 델타를 각각 포함하는 여러 청크를 보냅니다.

최종 청크에는 사용량 데이터가 포함되어 있습니다. 이 객체에는 요청에 의해 소모된 총 입력 및 출력 토큰이 포함되어 있습니다. 이 데이터를 사용하여 로컬 크레딧 잔액을 업데이트하거나 실시간으로 지출을 모니터링할 수 있습니다. 스트리밍은 사용자가 즉각적인 피드백을 기대하는 채팅 인터페이스에 이상적입니다.

함수 호출 및 JSON 모드

API는 JSON 모드와 함수 호출을 통해 구조화된 출력을 지원합니다. response_format을 {"type": "json_object"}로 설정하여 모델이 유효한 JSON을 반환하도록 강제할 수 있습니다. 이는 파싱 오류 없이 데이터를 추출하거나 구조화된 구성을 생성하는 데 유용합니다.

함수 호출의 경우 요청에 tools 배열을 제공합니다. 모델은 함수가 필요하다고 판단할 경우 tool_calls로 응답합니다. 그런 다음 함수를 실행하고 결과를 모델로 다시 보낼 수 있습니다. 이를 통해 외부 파싱 로직 없이 복잡한 다단계 워크플로우를 구현할 수 있습니다.

制限とエラーの処理

키당 분당 300회 요청, 동시 요청 8개로 제한됩니다. 이 제한을 초과하면 429 Too Many Requests 오류가 발생합니다. 응답 본문에는 retry-after 정보가 포함됩니다. 불필요한 재시도를 피하기 위해 클라이언트 측 스로틀링을 조정하세요.

선불 크레딧이 고갈되면 API에서 402 Payment Required 오류를 반환합니다. 언제든지 암호화폐를 통해 크레딧을 충전할 수 있습니다. 오류와 거부는 무료이므로 성공적인 토큰 생성에 대해서만 요금이 부과됩니다. 컨텍스트 창은 프롬프트와 완료를 합쳐 100,000 토큰입니다.

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.howmuchisanapikey.com/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)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.howmuchisanapikey.com/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);

스트리밍

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)