Acestep 파이프라인용 Quickstart

전제 조건: API 키 가져오기

요청을 하기 전에 유효한 API 키가 필요합니다. acestep.cc의 API 키 받기 페이지를 방문하세요. Google로 계속하기를 사용하거나 이메일과 비밀번호 계정을 생성하여 가입할 수 있습니다. 전화번호는 필요하지 않습니다. 등록하면 API 키가 즉시 표시됩니다. 이 키를 복사하세요. 이후 모든 요청을 인증하는 데 사용합니다. 크레딧이 없으면 충전해야 합니다. $10에서 $500 사이의 금액에는 암호화폐 결제만 받습니다(TRC20의 USDT 또는 Base의 USDC). 새 계정에는 7일 동안 유효한 $0.50의 무료 체험 크레딧이 제공되며, 시작 시 카드가 필요하지 않습니다. 키를 안전하게 보관하세요. 이 키는 속도 제한 및 토큰 사용량에 대한 사용 내역을 검증하는 데 사용됩니다.

설치

API는 표준 OpenAI 호환 프로토콜을 사용합니다. 선호하는 언어에 대한 공식 OpenAI SDK 또는 모든 HTTP 클라이언트를 사용하여 상호 작용할 수 있습니다. Python의 경우 openai 패키지를 설치하세요. Node.js의 경우 openai을 설치하세요. 사용자 지정 기본 URL을 지원하는 최신 버전의 SDK를 사용하고 있는지 확인하세요. 우리 서비스의 기본 URL은 https://api.acestep.cc/v1입니다. 이렇게 하면 기본 URL과 API 키를 바꾸기만 하면 OpenAI 엔드포인트를 기대하는 기존 파이프라인 코드를 재사용할 수 있습니다. 요청에 지정해야 하는 모델 ID는 uncensored입니다. 이 모델은 합법적인 성인, 픽션 또는 논쟁적 주제에 대한 최소 거부를 위해 조정된 오픈 웨이트 LLM으로, 콘텐츠 필터가 유효한 크리에이티브 출력을 차단할 수 있는 크리에이티브 파이프라인에 이상적입니다.

기본 요청: 텍스트 생성

시스템 프롬프트와 사용자 메시지를 사용하여 /v1/chat/completions로 POST 요청을 보내세요. 모델은 완성 텍스트를 반환합니다. model 매개변수를 uncensored로 설정하세요. temperature 및 top_p로 창의성을 제어할 수 있습니다. 컨텍스트 창은 프롬프트와 완성을 합해 최대 100,000개의 토큰을 지원합니다. 요청당 최대 출력은 32,000개의 토큰이며, max_tokens을 지정하지 않으면 2,048개입니다. 오류와 거부는 크레딧을 소모하지 않지만, 성공적인 토큰 생성은 소모합니다. 이 엔드포인트는 스크립트 생성, 캡션 작성 또는 음성 또는 이미지 생성 API와 같은 다른 모달리티로 전달하기 전에 텍스트 데이터 처리에 사용합니다.

스트리밍 응답

실시간 업데이트를 위해 요청에 stream: true을 설정하세요. API는 SSE를 반환합니다. 각 청크에는 일부 텍스트가 포함됩니다. 토큰 사용 세부 정보는 스트림의 마지막 청크에서 제공됩니다. 이는 텍스트가 생성되는 대로 표시하는 애플리케이션에 유용하며 사용자의 지각된 지연 시간을 개선합니다. 클라이언트가 SSE를 올바르게 처리하도록 하세요. 스트림을 사용하면 토큰이 도착하는 대로 처리할 수 있어 파이프라인의 장문 콘텐츠 생성에 유용합니다. 스트리밍이 가격 책정이나 토큰 제한을 변경하지 않는다는 점을 기억하세요. 생성된 총 토큰에 대해 여전히 요금이 청구됩니다.

함수 호출

API는 함수 호출을 지원하여 모델이 정의된 도구를 기반으로 구조화된 데이터를 출력할 수 있습니다. tools 매개변수에서 함수를 정의하세요. tool_choice을 auto 또는 특정 함수 이름으로 설정하세요. 모델이 적절한 경우 함수 호출 객체로 응답합니다. 이는 텍스트에서 구조화된 데이터를 추출하거나 하위 호출 API를 위한 입력을 준비하는 데 유용합니다. response_format을 {"type": "json_object"}로 설정하여 JSON 출력을 강제할 수도 있습니다. 이는 모델이 유효한 JSON을 반환하도록 보장하여 자동화된 파이프라인에 대한 신뢰할 수 있는 통합에 중요합니다. 이러한 기능을 사용하여 텍스트 처리 단계의 신뢰성을 향상시키세요.

가격 및 제한

가격은 입력 토큰 100만 개당 $0.25, 출력 토큰 100만 개당 $1.00입니다. 크레딧은 선불 크레딧이며 만료되지 않습니다. 오류는 무료입니다. 속도 제한은 키당 분당 300개 요청, 키당 동시에 8개 요청입니다. 최대 요청 본문 크기는 8 MB입니다. 속도 제한을 초과하면 429 오류가 발생합니다. 401 오류는 유효하지 않거나 만료된 키를 나타냅니다. 402 오류는 크레딧이 부족함을 의미합니다. 크레딧에 대한 환불은 제공되지 않으며, 이의 제기는 지원 페이지를 통해 처리됩니다. 계정당 활성 키는 하나만 허용되며, 새 키를 생성하면 이전 키가 대체됩니다. 파이프라인의 재시도 로직을 설계할 때 이러한 제한 사항을 고려하세요.

cURL

Copycurl https://api.acestep.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

스트리밍

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)