레퍼런스 · 인증

Photta API 인증 단일 키, 단일 헤더

한 줄 요약

모든 Photta API 호출 시 키를 `Authorization: Bearer photta_live_xxx` 형태로 전달하십시오. 키는 대시보드에서 생성되며, endpoint별 scope 제한 없이 단일 credits 잔액을 공유합니다.

API 키 발급받기문서 보기
  • 인증: Bearer 키
  • 제한 사항: 600 requests/min
  • 처리 방식: 비동기, 폴링

이 페이지의 모든 수치는 다음 출처를 기반으로 합니다: Photta API 문서 · 확인 완료

API 요구 사항

인증 한눈에 보기

헤더
Authorization: Bearer photta_live_xxx
키 접두사
photta_live_
기본 URL
https://api.photta.app/api/v1
키 생성 위치
https://ai.photta.app
Scope
단 하나의 키로 모든 endpoint 접근 및 단일 credits 잔액 공유

단 한 번의 호출로 키 확인

계정 endpoint는 무료이므로 키의 정상 동작 여부를 안전하게 확인할 수 있습니다.

curl https://api.photta.app/api/v1/account \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

키 관리

  • 유출 의심 시 즉시 교체

    문서에 명시되어 있듯, 키 유출이 의심되면 즉시 교체(rotate)하십시오. 대체 키를 먼저 생성하여 배포한 다음 기존 키를 폐기하십시오.

  • 서버에만 보관

    브라우저에 키가 노출되면 해당 페이지를 여는 모든 사용자에게 노출되는 것과 같습니다. API는 백엔드에서 호출하고 결과만 클라이언트에 전달하십시오.

  • 401은 요청이 아닌 키 문제

    키가 누락되었거나 유효하지 않거나 만료된 경우 `authentication_error`가 반환됩니다. 다른 곳을 점검하기 전에 헤더의 오타나 불필요한 공백부터 확인하십시오.

  • 모든 키가 공유하는 단일 잔액

    키는 기능별로 scope가 나뉘지 않습니다. 여러 환경을 위해 여러 키를 사용하더라도 동일한 credits 잔액을 차감하며, 잔액은 GET `/api/v1/account`로 확인할 수 있습니다.

인증 관련 자주 묻는 질문

요청을 어떻게 인증하나요?

모든 호출 시 Authorization 헤더에 Bearer 토큰으로 키를 전송하세요. 별도의 로그인이나 토큰 교환 단계는 없습니다.

키는 어디에서 생성하나요?

Photta 대시보드에서 생성합니다. 키 교체 발급도 동일한 위치에서 진행되며, 401 발생 시 문서에서도 해당 위치를 안내합니다.

브라우저에서 직접 API를 호출할 수 있나요?

보유한 키로는 불가능합니다. 브라우저로 전달되는 모든 요소는 방문자에게 노출되므로, 자체 서버 뒤에 호출을 두고 결과를 전달하세요.

키가 유출되면 어떻게 해야 하나요?

즉시 교체하세요 — 새 키를 생성하여 배포한 다음 기존 키를 삭제합니다. 이미 사용된 credits는 복구할 수 없으므로, 먼저 교체한 후 원인을 조사하세요.

Endpoints 및 레퍼런스

이 페이지의 모든 수치는 다음 출처를 기반으로 합니다: Photta API 문서 · 확인 완료

5분 만에 API 체험하기

Photta API 키를 발급받고 위 cURL 스니펫을 붙여넣기만 하면, 커피가 다 내려지기도 전에 첫 번째 모델 착용 컷을 받아볼 수 있습니다.

계정 생성 후 API 키 발급받기API
  • Bearer 키
  • 600 requests/min
  • 비동기, 폴링