개발자를 위한 API 문서

Base URL 및 인증

기본 URL은 HTTPS://api.ollamaapiurl.com/v1입니다. 고유한 API 키를 Authorization 헤더에 전달하여 인증합니다. 이 키는 모든 요청에 대한 자격 증명 역할을 합니다. 가입 직후 대시보드에서 이를 검색하십시오.

• 키는 안전하게 보관하세요. 이 키는 선불 크레딧에 대한 전체 접근 권한을 부여합니다.
• 설정 페이지에서 언제든지 새 키를 생성하세요.

API 키 시스템은 간단합니다. 계정당 활성 키 하나만 명확한 추적을 보장합니다. 접근 권한을 잃으면 즉시 재생성할 수 있습니다. 전화번호 인증이 진입을 막지 않습니다.

첫 번째 요청

표준 HTTP를 사용하여 첫 번째 프롬프트를 보내세요. 엔드포인트는 텍스트 입력을 받아 텍스트 출력을 반환합니다. 이 방법은 선호하는 모든 HTTP 클라이언트 라이브러리에서 작동합니다.

Copycurl https://api.ollamaapiurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the local library"}]
  }'

응답에는 토큰 사용량이 포함됩니다. 처리된 토큰에 대해서만 요금이 부과됩니다. 오류는 선불 잔액을 소모하지 않습니다. 이러한 투명성으로 지출을 정확히 제어할 수 있습니다.

Python SDK 통합

공식 OpenAI Python 라이브러리를 사용하세요. base URL을 우리 엔드포인트로 지정하세요. model id를 uncensored로 설정하세요. 이는 로컬 설정 번거로움 없이 uncensored 동작을 얻도록 보장합니다.

Copyfrom openai import OpenAI

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

라이브러리는 재시도 및 포매팅을 자동으로 처리합니다. 구조화된 JSON 또는 원본 텍스트를 얻습니다. 스트리밍도 지원됩니다. 이 방식은 코드를 깔끔하고 유지보수 가능하게 유지합니다.

Node SDK 설정

openai 패키지를 설치하세요. 기본 URL을 당사 서비스로 설정하세요. 환경에서 API 키를 설정하세요. 이 설정은 Python 구성과 밀접하게 일치합니다.

Copyimport OpenAI from "openai";

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

Node 개발자는 일관된 동작을 얻습니다. 모델이 프롬프트에 즉시 응답합니다. 복잡한 라우팅 로직 없이 웹 서버나 백그라운드 워커에 통합할 수 있습니다.

스트리밍 응답

stream을 true로 설정하여 스트리밍을 활성화합니다. API는 생성되는 대로 청크를 반환합니다. 이는 사용자의 지각된 지연 시간을 줄입니다. 화면에 표시되는 대로 토큰을 표시할 수 있습니다.

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)

마지막 청크에는 총 토큰 수가 포함됩니다. 이는 청구 검증에 사용하세요. 스트리밍은 모든 파라미터와 함께 작동합니다. 함수 호출도 지원합니다. 사용자는 실시간으로 진행 상황을 볼 수 있습니다.

제한 사항, 오류 및 컨텍스트

컨텍스트 윈도우는 프롬프트와 completion을 합쳐 총 100,000 토큰입니다. 요청당 최대 16,000 토큰을 출력할 수 있습니다. 속도 제한은 분당 300개 요청을 허용합니다. 동시 요청은 키당 8개로 제한됩니다.

자주 발생하는 오류에는 키가 잘못되어 401이 포함됩니다. 402 오류는 선불 크레딧이 고갈되었음을 의미합니다. 429 응답은 속도 제한에 도달했음을 신호합니다. 암호화폐로 충전하려면 대시보드를 확인하십시오. 크레딧은 만료되지 않습니다. 이중 청구와 같은 실수는 지원을 통해 수정됩니다.