문서
시작하기/빠른 시작

빠른 시작

몇 분 안에 사진 복원 API를 시작하세요. 이 가이드는 AI 기반 사진 복원을 애플리케이션에 통합하는 필수 단계를 안내합니다.

사전 요구사항

시작하기 전에 다음을 확인하세요:

  • 계정: restoreoldphotos.online에서 등록
  • API 키: 설정에서 API 키 생성
  • 크레딧: 사진 복원 크레딧 구매
  • 이미지 URL: 테스트용 공개 접근 가능한 이미지 URL

1단계: API 키 받기

  1. restoreoldphotos.online 방문
  2. Google 계정으로 로그인
  3. 설정 > API 키로 이동
  4. "새 API 키 만들기" 버튼 클릭
  5. 키 이름 입력 (예: "내 앱")
  6. 키 생성 후 전체 키 값을 복사 (안전하게 보관하세요!)

API 키 형식

  • sk-로 시작
  • 무작위로 생성된 문자 포함
  • 예시: sk-abc123def456ghi789...

2단계: 첫 번째 API 호출하기

cURL 사용

curl -X POST https://restoreoldphotos.online/api/api-call/photo-restore \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "imageUrl": "https://example.com/old-photo.jpg"
  }'

JavaScript 사용

async function restorePhoto(imageUrl, apiKey) {
  try {
    const response = await fetch('https://restoreoldphotos.online/api/api-call/photo-restore', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${apiKey}`
      },
      body: JSON.stringify({
        imageUrl: imageUrl
      })
    });
 
    if (!response.ok) {
      throw new Error(`API Error: ${response.status}`);
    }
 
    const result = await response.json();
    return result.output; // URL 또는 base64 문자열
  } catch (error) {
    console.error('Error:', error);
    throw error;
  }
}
 
// 사용법
const restoredImage = await restorePhoto(
  'https://example.com/old-photo.jpg',
  'your-api-key-here'
);
console.log('Restored image:', restoredImage);

3단계: 응답 처리

API는 복원된 이미지가 포함된 JSON 응답을 반환합니다:

{
  "output": "https://replicate.delivery/pbxt/xxx.png"
}

또는 base64 형식:

{
  "output": "data:image/png;base64,iVBORw0KGgoAAAANS..."
}

output 필드에는 다음이 포함됩니다:

  • 이미지 URL: 복원된 이미지로의 직접 링크
  • Base64 문자열: base64로 인코딩된 이미지 데이터

4단계: 결과 표시

HTML에서

<img src="https://replicate.delivery/pbxt/xxx.png" alt="복원된 사진" />

JavaScript에서

// URL 또는 base64용
const img = document.createElement('img');
img.src = restoredImage; // API 응답의 output 필드
document.body.appendChild(img);

5단계: 오류 처리

항상 적절한 오류 처리를 구현하세요:

try {
  const restoredImage = await restorePhoto(imageUrl, apiKey);
  // 성공 처리
} catch (error) {
  if (error.message.includes('401')) {
    console.error('잘못된 API 키');
  } else if (error.message.includes('402')) {
    console.error('크레딧 부족');
  } else if (error.message.includes('429')) {
    console.error('속도 제한 초과');
  } else {
    console.error('API 오류:', error.message);
  }
}

API 키 관리

설정에서 키 관리

  • 모든 API 키 목록 보기
  • 키 사용 통계 보기
  • 사용하지 않는 키 비활성화 또는 삭제
  • 키의 마지막 사용 시간 보기

보안 모범 사례

  • API 키를 클라이언트 측 코드에 하드코딩하지 마세요
  • 환경 변수를 사용하여 키 저장
  • API 키를 정기적으로 교체
  • 다른 환경에 대해 다른 키 사용

환경 변수 예시

# .env 파일
PHOTO_RESTORE_API_KEY=sk-your-api-key-here
// 코드에서 사용
const apiKey = process.env.PHOTO_RESTORE_API_KEY;