API 문서

Base URL 및 인증

API는 다음에 위치합니다 https://api.ollamaapidoc.com/v1Bearer 토큰을 사용하여 인증합니다 Authorization header. 대시보드에서 Google 또는 이메일을 통해 즉시 키를 생성하세요. 전화번호가 필요하지 않습니다. 이 키는 베이스 URL을 설정하여 표준 OpenAI SDK와 함께 작동합니다.

첫 번째 요청

POSTリクエストを送信 /v1/chat/completions 모델 ID uncensored. 이 엔드포인트는 텍스트 입력과 텍스트 출력을 처리합니다. 스트리밍, JSON 모드, 함수 호출을 지원합니다. 먼저 모델 엔드포인트를 확인하여 크레딧을 쓰지 않고 연결성을 테스트할 수 있습니다.

Copycurl https://api.ollamaapidoc.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all installed models"}]
  }'

응답은 표준 OpenAI 형식을 반환합니다. 오류는 적절한 HTTP 코드를 반환합니다. 본문을 확인하세요. error 무언가 실패할 경우 세부 정보. 스트리밍 응답은 Server-Sent Events를 사용합니다.

Python SDK 통합

공식 OpenAI 라이브러리를 설치하세요. 기본 URL과 API 키를 사용하여 클라이언트를 구성하세요. chat completions 엔드포인트를 호출하세요. 코드는 표준 OpenAI 사용법과 동일합니다. 이는 기존 프로젝트의 쉬운 마이그레이션을 보장합니다. 호출 시 temperature와 top_p와 같은 매개변수를 직접 조정할 수 있습니다.

Copyfrom openai import OpenAI

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

속도 제한이나 잘못된 키에 대한 예외를 처리하세요. stream을 true로 설정하면 라이브러리는 토큰을 스트리밍합니다. 이 방식은 코드베이스를 깔끔하게 유지하고 호환성을 보장합니다.

Node.js SDK 설정

을 사용하세요 openai npm 패키지입니다. 커스텀 base URL로 클라이언트를 초기화하세요. API 키를 전달하세요. 구문은 Python 예제와 유사합니다. 이러한 일관성은 디버깅 시간을 줄여줍니다. 대화 기록 배열에 여러 메시지를 보낼 수 있습니다.

Copyimport OpenAI from "openai";

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

응답을 신중하게 파싱하세요. API는 구조화된 JSON을 반환합니다. 프로덕션 앱에서는 오류 처리가 중요합니다. 네트워크 오류와 API 고유 오류를 별도로 캐치하세요. 이를 통해 앱이 높은 트래픽 중에도 응답 상태를 유지합니다.

스트리밍 및 JSON 모드

스트리밍을 활성화하려면 stream true로 설정하세요. API는 서버 전송 이벤트를 통해 토큰을 전송합니다. 실시간으로 부분 응답을 받습니다. 이는 긴 출력의 사용자 경험을 향상시킵니다. JSON 출력을 강제할 수도 있습니다. response_format. 구조화된 데이터 추출에 유용합니다.

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)

함수 호출은 유사하게 작동합니다. 요청에서 도구를 정의합니다. 모델은 도구 호출을 반환합니다. 코드에서 이러한 호출을 파싱합니다. 실행하고 결과를 모델에 피드백합니다. 이 루프는 복잡한 워크플로우를 가능하게 합니다.

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

컨텍스트 윈도우는 100,000 토큰입니다. 최대 출력은 요청당 16,000 토큰입니다. 오류에는 유효하지 않은 키에 대한 401과 부족해진 크레딧에 대한 402가 포함됩니다. 속도 제한은 분당 300회 요청으로 제한됩니다. 앱에서 이를 우아하게 처리하세요. API는 프롬프트를 학습에 사용하지 않습니다. 프라이버시가 유지되며, 크레딧은 만료되지 않습니다.