모델 게시 API (Push a model)

모델 게시 API (Push a model)

직접 만든 커스텀 모델을 다른 사람이 쓸 수 있게 ollama.com에 올리고 싶다면, POST /api/push 엔드포인트가 그 작업을 해 줍니다. CLI의 ollama push와 같은 일을 하는 API예요. 모델을 등록·복사한 뒤, 이 API로 공개 레지스트리에 게시하는 흐름이에요.

요청

게시할 모델 이름과 함께 POST 요청을 보냅니다.

curl http://localhost:11434/api/push -d '{
  "model": "my-username/my-model"
}'

스트리밍을 끄려면 stream: false를 추가할 수 있어요.

curl http://localhost:11434/api/push -d '{
  "model": "my-username/my-model",
  "stream": false
}'

요청 파라미터

PushRequest 스키마 기준이에요.

  • model (필수, string) — 게시할 모델의 이름
  • insecure (boolean) — 기본값은 false

응답

200 응답으로 게시 상태 업데이트가 스트리밍됩니다. 상황에 따라 콘텐츠 다이제스트, 총 예상 바이트(total), 지금까지 전송된 바이트(completed)를 담아요.

사전 조건

모델을 게시하려면 먼저 ollama.com 계정과 Ollama Public Key가 연결돼 있어야 해요. 또 모델 이름이 사용자 이름 형식(my-username/my-model)을 따라야 합니다. 가이드는 이 위키의 Import 문서 "모델을 ollama.com에 공유하기" 절을 참고하세요. 게시가 끝나면 누구든 ollama run my-username/my-model로 그 모델을 가져다 쓸 수 있어요.