Magnific API

이 문서는 번역본입니다. 영어 버전이 기준이며, 의문이 생길 경우 영어 버전이 우선합니다.

Magnific의 스톡 에셋 라이브러리와 AI 기반 툴을 여러분의 애플리케이션에 통합해 보세요

Magnific API를 통해 개발자는 Magnific의 콘텐츠와 AI 기능을 자신의 제품, 플랫폼, 워크플로에 직접 통합할 수 있어요. Magnific 웹사이트를 수동으로 이용하는 대신, 표준 REST API 호출을 통해 스톡 에셋을 검색하고, AI 이미지와 동영상을 생성하고, 콘텐츠를 편집하는 등 다양한 작업을 프로그래밍 방식으로 수행할 수 있어요

엔드포인트, 파라미터, 인증 상세 정보, 코드 예제, 응답 스키마를 포함한 전체 기술 레퍼런스는 API 문서(docs.magnific.com)에서 확인할 수 있어요. 이 글에서는 API의 주요 기능과 시작 방법을 이해하는 데 필요한 핵심 내용을 다뤄요

API로 할 수 있는 작업

API는 여러 서비스 영역으로 구성되어 있어요:

서비스	기능
스톡 콘텐츠	2억 개 이상의 에셋(벡터, 사진, 아이콘, PSD 파일 등)을 검색하고 필터링하여 다운로드해 보세요
AI 이미지 생성	Mystic, Flux를 포함한 다양한 AI 모델을 사용하여 프롬프트에서 이미지를 생성해 보세요
AI 동영상 생성	AI 모델을 사용하여 텍스트나 이미지 인풋으로 동영상을 만들어 보세요
이미지 편집	배경 제거, Magnific으로 이미지 업스케일, 필터 적용 및 기타 편집 작업을 프로그래밍 방식으로 수행해 보세요
아이콘	형식 및 스타일 필터를 사용하여 아이콘을 검색하고 다운로드해 보세요
오디오	AI를 통해 음성 효과와 오디오 콘텐츠를 생성해 보세요

Magnific이 새로운 AI 기능을 추가함에 따라 이용 가능한 서비스와 모델은 변경될 수 있어요. 최신 엔드포인트 목록은 docs.magnific.com에서 확인해 보세요

시작하기

API를 통해 크레딧을 사용하는 방법

1단계 — 설정 액세스
사용자 메뉴를 열고 조직 설정으로 이동해 보세요. 그 안에서 API 키 섹션을 찾을 수 있어요

2단계 — API 키 생성
식별 가능한 이름을 지정하여 새로운 API 키를 생성해 보세요. 시스템이 자동으로 다음을 생성해요:

API 키
웹훅 서명 시크릿

두 항목 모두 한 번만 표시돼요. 창을 닫기 전에 반드시 복사해 두세요

3단계 — 키 관리

작업 메뉴에서 키의 시크릿이나 사용 기록을 잃지 않고 언제든 이름을 변경할 수 있어요
키를 삭제하지 않고 일시적으로 비활성화할 수 있어요(키 교체나 긴급 상황 시 유용해요)
확인 절차를 거쳐 키를 영구적으로 삭제할 수 있어요

4단계 — 크레딧 사용량 감사
특정 API 키별로 필터링하여 크레딧 풀 소비량을 감사하고 사용량을 세밀하게 관리할 수 있어요

엔터프라이즈 계정: API 키 섹션이 보이지 않는다면 담당 Magnific 매니저에게 문의하여 액세스 권한을 요청하세요. 활성화되면 위 단계와 동일하게 이용할 수 있어요

API 대시보드(레거시)

API 대시보드는 API 사용과 관련된 모든 것을 관리하는 중심 허브예요. 우측 상단 프로필 사진을 클릭하고 API 대시보드를 선택하거나, magnific.com/developers/dashboard로 직접 이동하여 접속할 수 있어요

대시보드에서 다음 작업을 수행할 수 있어요:

API 키 확인 및 재생성
사용량 추적 및 실시간 요청 볼륨 모니터링
월간 예산을 설정하여 지출을 관리해 보세요
요금 제한과 각 서비스별 가격 책정을 확인해 보세요
결제 정보와 결제 수단을 관리해 보세요

크레딧 기반 모델 API 관리 패널

구독 기반 API 사용자는 구독 패널 내에 위치한 관리 패널을 통해 계정을 관리할 수 있어요. 이곳에서 다음 작업을 수행할 수 있어요:

가격 책정 및 결제

Magnific API는 크레딧 기반 모델의 구독 시스템을 사용해요

AI 생성 툴

이미지, 동영상, 오디오, 업스케일링, 편집 등 모든 API 생성 요청 시 잔여 크레딧이 차감돼요

API를 사용하려면 다음 요금제 중 하나를 선택해 보세요:

Premium: API 키 1개, 월 20,000 크레딧 또는 연 240,000 크레딧
Premium+: API 키 1개, 월 45,000 크레딧 또는 연 600,000 크레딧
Pro: API 키 3개, 월 300,000 크레딧 또는 연 4,000,000 크레딧
Business: API 키 5개, 월 90,000 크레딧 또는 연 1,080,000 크레딧
Enterprise: 무제한 API 키, 맞춤형 연간 크레딧, 사용량에 따른 확장 지원

각 툴과 생성 작업에 대한 상세 크레딧 비용은 도움말 센터에서 확인할 수 있어요

모든 요금제에서 웹사이트를 통한 직접적인 콘텐츠 생성도 가능해요

요금제에 "무제한" 사용이 포함된 경우, 이는 Magnific 웹 앱 내에서만 적용된다는 점을 참고해 주세요. API 호출은 항상 크레딧을 차감합니다

스톡 콘텐츠 다운로드

Premium, Premium+, Pro 요금제: API를 통한 스톡 다운로드는 크레딧을 차감하지 않지만, 하루 100회로 제한됩니다
Business 및 엔터프라이즈 요금제: 스톡 다운로드는 무제한이며, 다른 모든 API 호출과 마찬가지로 크레딧 잔액에서 차감됩니다

요청 제한

API는 모든 개발자를 위한 안정성과 공정한 사용을 보장하기 위해 요청 제한을 적용합니다. 제한은 API 키 및 IP 주소 수준 모두에 적용됩니다

제한 유형	임계값
초당 버스트	5초 동안 초당 50회 요청
평균 속도	2분 동안 평균 초당 10회 요청
일일 제한	서비스마다 다릅니다. 대시보드에서 구체적인 RPD(일일 요청 수) 및 IPD(일일 이미지 수) 제한을 확인해 보세요

제한을 초과하면 제한이 초기화될 때까지 요청이 제한되거나 일시적으로 차단될 수 있어요. 애플리케이션에 더 높은 제한이 필요하다면 영업 팀에 문의하여 맞춤형 요금제를 논의해 보세요

사용 규칙

Magnific API는 디지털 제품 및 워크플로 통합을 위해 설계되었습니다. API 액세스를 유지하려면 다음 규칙을 따라야 해요:

데이터 마이닝, 콘텐츠 스크래핑 또는 AI 모델 학습에 API를 사용하지 마세요
수정 없이 Magnific 콘텐츠를 판매하거나 재배포하지 마세요
다운로드 수를 정확하게 보고하세요: 리소스가 사용자에게 고유하게 사용될 때마다 다운로드 요청을 트리거하세요. 예를 들어, 누군가 블로그 게시물을 위해 이미지를 선택하거나, 헤더로 설정하거나, 배경으로 사용할 때가 해당됩니다
캐싱은 허용되지만 활성 요금제를 유지하고 모든 다운로드 내역을 정확하고 신속하게 보고해야 해요

중요
이 규칙을 위반하면 즉시 API 액세스 권한이 제거돼요

일반적인 오류 코드

요청에 문제가 발생하면 API는 표준 HTTP 상태 코드를 반환해요. 가장 일반적인 코드는 다음과 같아요:

코드	의미	조치 방법
401 Unauthorized	API 키가 유효하지 않거나 누락되었어요	x-magnific-api-key 헤더에 API 키가 포함되어 있는지, 형식이 올바른지 확인해 보세요
404 Not Found	엔드포인트나 리소스가 존재하지 않아요	URL과 요청 파라미터를 다시 확인해 보세요
429 Too Many Requests	요청 한도를 초과했어요	한도가 초기화될 때까지 기다리거나, 요금제를 업그레이드하거나, 더 높은 한도가 필요하면 영업팀에 문의해 보세요
500 Internal Server Error	서버 측 문제예요	요청을 다시 시도해 보세요. 문제가 지속되면 지원팀에 문의해 보세요

전체 응답 코드와 그 의미에 대한 자세한 내용은 API 문서를 참고해 보세요

리소스 및 지원

리소스	URL
전체 API 문서	docs.magnific.com
API 랜딩 페이지	magnific.com/api
API 대시보드	magnific.com/developers/dashboard
API 플레이그라운드	magnific.com/api/playground
API 가격 책정	magnific.com/api/pricing
영업팀 문의	magnific.com/api#contact

API 통합 과정에서 문제가 발생하거나 궁금한 점이 있다면 magnific.com/api#contact의 문의 양식이나 일반 지원 페이지를 통해 지원팀에 연락해 보세요