Replicate.com 가입 및 API 호출 (1)

1. Replicate 소개

2. 회원가입 & 로그인

1. GitHub 계정 준비 – 현재 Replicate 로그인은 GitHub OAuth 기반입니다. Sign in with GitHub 화면이 열리면 GitHub 자격으로 승인하면 끝!

2. 최초 로그인 시 결제정보 입력 없이 기본 무료 크레딧이 지급됩니다(체험용). 추가 사용량은 뒤 7-장 참고.

TIP : 이미 GitHub 2FA를 사용하고 있다면 별도 이메일 인증 없이 바로 가입이 완료됩니다.

3. API 토큰 발급

1. 로그인 후 상단 프로필 ▸ “API Tokens” 메뉴로 이동

2. 토큰 이름 입력 → Create token → 복사해 안전한 곳(.env 등) 보관

3. 필요 시 다중 토큰 발급·철회 가능

4. 모델 사용하기

4-1. cURL (동기 Sync 모드)

• 모델 상세 → Playground → HTTP → 예제 코드 제공 → 복사 → n8n HTTP Request 노드 → “import cURL” 기능 활용 (단, Header의 Authorization은 삭제하고 n8n인증 시스템을 써야함.)

• Prefer: wait 헤더를 주면 최대 60 초 동안 응답을 붙잡아 결과를 바로 돌려줍니다.

curl -s -X POST \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Prefer: wait" \
  -d $'{
    "input": {
      "mode": "standard",
      "prompt": "a woman takes her hands out her pockets and gestures to the words with both hands, she is excited, behind her it is raining",
      "duration": 5,
      "start_image": "https://replicate.delivery/xezq/rfKExHkg7L2UAyYNJj3p1YrW1M3ZROTQQXupJSOyM5RkwQcKA/tmpowaafuyw.png",
      "negative_prompt": ""
    }
  }' \
  https://api.replicate.com/v1/models/kwaivgi/kling-v2.1/predictions

4-2. 비동기 Async 모드

4-3. n8n에서 노드 및 인증 생성

• n8n 워크플로 Editor에서 “HTTP Request” 노드 검색 후 클릭 및 추가

• 상단 [ Import cURL] 버튼 클릭수 cURL Command 입력란에 위의 샘플 코드를 전체복사해서 붙여넣고 [Import] 클릭

• Header Parameters에 자동 삽입된 Authorization 파라미터는 삭제.

• Authentication 목록에서 [ Generic Credential Type ] 선택

• Generic Auth Type 목록에서 [ Bearer Auth ] 선택

• Bearer Auth 목록에서 [ + Create new credentail ] 선택

• 계산기 & 툴
  사이트를 사용해서 나만의 Token 생성하고 별도 장소 기록한뒤, n8n Credential 생성 팝업창의 Bearer Token 입력란에 붙여 넣을 것.

5. 모델 / 버전 ID 찾기

• 상단 메뉴의 [Explore] → Explore models → Category 선택 or Search 입력 활용.

• 모델 페이지 ▸ 상단 API 탭 → owner/model 형식 자동 복사

6. 가격 정책 & 한도

• 모델 종류에 따른 과금 (Pay-as-you-go 방식)
• Public 모델 : 컴퓨트 시간만 청구(부트·대기 무료)
• Private 모델/배포 : 기본적으로 부트 + Idle 시간 포함, 단 fast-boot 옵션은 처리 시간만 과금.

• 무료 크레딧 : 신규 계정에 소액 지급(시기별 상이). 대량 사용 시 결제수단 등록 필요.

• https://replicate.com/pricing 에서 모델별로 상세히 확인 할수 있음

7. 사용 시 자주 묻는 질문 (FAQ)