모델 복사 API (Copy a model)

커스텀 모델을 만들기 전에 기존 모델을 하나 더 만들어 두고 싶을 때가 있어요. POST /api/copy 엔드포인트가 모델을 새 이름으로 복사해 줍니다. CLI의 ollama cp와 같은 일을 하는 API예요. 보통 커스텀 모델 이름을 정리하거나, 원본을 건드리지 않고 바탕 모델을 하나 떠 놓을 때 씁니다.

요청

source 와 destination 을 지정해 POST 요청을 보내요.

curl http://localhost:11434/api/copy -d '{
  "source": "gemma4",
  "destination": "gemma4-backup"
}'

요청 파라미터

CopyRequest 스키마 기준이에요.

source (필수, string) — 복사할 기존 모델 이름
destination (필수, string) — 새로 만들 모델 이름

활용

복사본은 완전히 별개의 이름으로 로컬 모델 목록에 추가되지만, 실제 가중치는 공유되는 구조라 디스크를 이중으로 차지하지 않아요. 그래서 이 문서의 Import 가이드에서도 ollama.com에 push하기 전에 ollama cp(즉 이 API)로 모델에 올바른 사용자 이름을 붙이라고 안내합니다. 굳이 무거운 모델을 다시 받지 않고 이름만 복제하는 셈이죠.