레퍼런스 · 오류

Photta API 오류 모든 오류 유형 및 해결 방법

한 줄 요약

모든 Photta API 실패는 동일한 포맷을 반환합니다: 상태 코드, `error.type`, 메시지 및 `request_id`. 429는 Retry-After 헤더 이후에, 5xx는 지수 백오프를 적용해 재시도하세요. 400, 401, 402는 자체 코드에서 직접 수정해야 합니다.

API 키 발급받기 문서 보기

오류: 7개 오류 유형
Retry-After: Retry-After: 30s
제한 사항: 600 requests/min

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

오류 유형

API 문서에 게시된 전체 목록입니다.

상태타입의미

400invalid_request_error: The request is malformed or contains invalid parameters.
401authentication_error: The API key is missing, invalid, or expired.
402insufficient_credits_error: Your account does not have enough credits.
404not_found_error: The requested resource does not exist.
409conflict_error: The request conflicts with current state — e.g. your concurrent-batch cap is reached.
429rate_limit_error: Too many requests. Slow down and retry.Retry-After: 30
500api_error: An internal server error occurred. Retry later.

오류 포맷

어떤 오류가 발생하더라도 모든 endpoint에서 동일한 엔벨로프를 반환합니다.

{
  "error": {
    "type": "rate_limit_error",
    "message": "Rate limit exceeded."
  },
  "request_id": "req_xxxxxxxx"
}

실패 처리

Retry-After 준수
429 응답에는 Retry-After 헤더가 포함됩니다. 해당 시간(초)만큼 대기한 후 지수 백오프로 재시도하십시오. 즉시 재시도하면 다음 윈도우만 더 뒤로 밀려납니다.
실패 시 credits 환불
요청이 수락된 후 실패한 생성 작업은 credits가 자동으로 환불되므로, 재시도해도 중복 청구되지 않습니다.
request id 인용
모든 응답에는 `request_id`가 포함되어 있습니다. 이를 기록해 두십시오. 지원팀이 수천 건의 작업 중에서 특정 실패 건을 가장 빠르게 찾아낼 수 있는 방법입니다.
409는 큐 신호입니다
Conflict는 플랜의 동시 배치 상한선에 도달했음을 의미합니다. 이미 진행 중인 배치가 완료될 때까지 polling한 후 다시 제출하십시오. 헛돌지 마십시오.

API 오류 관련 질문

오류 바디는 어떻게 구성되나요?

`request_id`와 함께 `type` 및 `message`가 포함된 `error` 객체입니다. type은 일정하며 머신 리더블합니다. message는 사람을 위한 것이며 변경될 수 있습니다.

어떤 오류를 재시도해야 하나요?

Retry-After 시간(초)만큼 대기한 후의 429와 지수 백오프를 적용한 5xx입니다. 400, 401, 402는 클라이언트 측에서 무언가를 수정하기 전까지 동일하게 실패합니다.

402는 무엇을 의미하나요?

`insufficient_credits_error` — 계정에 해당 호출 또는 배치의 전체 예약분을 충당할 credits가 부족함을 나타냅니다. 아무것도 생성되지 않으며 비용도 청구되지 않습니다.

실패는 어떻게 리포트하나요?

`request_id`, 엔드포인트, 시간을 전달하십시오. 이 세 가지 정보로 정확한 호출을 식별할 수 있으므로 조회를 위해 이미지 자체는 필요하지 않습니다.

엔드포인트 및 레퍼런스

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

5분 만에 API 체험하기

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

계정 생성 후 API 키 발급받기 API

7개 오류 유형
Retry-After: 30s
600 requests/min