Iymau API 문서

인증 및 API 키

API 키는 모든 요청을 인증합니다. Google 또는 이메일로 가입하면 즉시 하나의 활성 키를 받게 됩니다. 이 키는 서비스의 비밀번호 역할을 하므로 안전하게 보관하세요. 분실 시 이전 활성 키를 대체하기 위해 새 키를 생성할 수 있습니다. 시스템은 실제 토큰 사용량에 따라 과금하므로 오류 및 거부 응답은 무료입니다. 언제든지 암호화폐로 충전할 수 있습니다.

Copycurl https://api.iyamau.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the capital of France?"}]
  }'

채팅 완료 엔드포인트를 사용한 첫 번째 요청

텍스트 생성을 위해 채팅 완료 엔드포인트로 POST 요청을 보내십시오. 표준 클라이언트와의 호환성을 보장하려면 대시보드에서 제공된 기본 URL을 사용하십시오. 이 전용 서비스의 모델 식별자는 항상 "uncensored"입니다. 창의성을 제어하기 위해 temperature 및 top_p과 같은 매개변수를 조정할 수 있습니다. 시스템은 프롬프트 및 메시지에 대해 표준 JSON 페이로드를 받습니다. 오류는 사전 지불된 크레딧을 소모하지 않습니다. 이 접근 방식은 선호하는 모든 OpenAI 호환 SDK와 함께 작동합니다.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.iyamau.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 클라이언트와의 연동

공식 Node.js SDK 또는 호환 가능한 라이브러리를 사용하여 API와 상호 작용하세요. base URL과 API 키로 클라이언트를 구성하세요. uncensored 모델은 표준 메시지 형식에 응답합니다. 대화형 컨텍스트를 위해 단일 요청에 여러 턴을 보낼 수 있습니다. 응답 객체에는 생성된 텍스트와 사용량 통계가 포함됩니다. 스트리밍은 실시간 토큰 제공을 지원합니다. 이 방법은 애플리케이션의 낮은 지연 시간을 보장합니다. 서비스는 서버에서 무거운 작업을 처리합니다.

Copyimport OpenAI from "openai";

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

스트리밍 응답 및 SSE

stream 파라미터를 true로 설정하여 스트리밍을 활성화하세요. 생성된 각 토큰에 대해 Server-Sent Events (SSE)를 받습니다. 이를 통해 생성되는 즉시 텍스트를 표시할 수 있습니다. 마지막 청크에는 요청에 대한 전체 토큰 사용량이 포함됩니다. 이 기능은 채팅 인터페이스와 라이브 애플리케이션에 이상적입니다. 이는 최종 사용자의 지각된 지연 시간을 줄입니다. 각 SSE 이벤트의 JSON 객체를 구문 분석할 수 있습니다. uncensored 모델은 이 표준 프로토콜을 효율적으로 지원합니다.

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)

파라미터: temperature, top_p 및 JSON 모드

표준 매개변수를 사용하여 생성 동작을 제어하세요. temperature를 설정하여 무작위성을 조정하세요. 높은 값은 창의성을 높입니다. top_p를 사용하여 어휘 분포를 필터링하세요. response_format을 json_object로 설정하여 JSON 모드를 활성화하면 구조화된 데이터를 얻을 수 있습니다. uncensored 모델은 이러한 제약 조건을 신뢰할 수 있게 준수합니다. 또한 생성을 조기에 중단하기 위해 stop 시퀀스를 지정할 수 있습니다. seed 값은 테스트 중 재현 가능한 결과를 제공합니다. 이러한 옵션은 출력 품질에 대한 정밀한 제어를 제공합니다.

Rate limits, 할당량 및 일반 오류

API는 키당 분당 300개의 요청을 제한합니다. 동시에 최대 8개의 동시 요청을 가질 수 있습니다. 각 요청 본문은 8 MB를 초과할 수 없습니다. 401 오류가 발생하면 API 키 유효성을 확인하세요. 402 오류는 선불 크레딧 부족을 나타내며, 크립토로 충전하여 서비스를 계속하세요. 429 오류는 속도 제한에 도달했음을 의미합니다. 몇 초간 대기 후 재시도하세요. 컨텍스트 윈도우는 총 100,000개의 토큰을 지원합니다. 이는 광범위한 문서 처리 또는 긴 대화를 가능하게 합니다.