API 기본 사항

Fit-it-on 개발자 API는 당사의 AI 생성 모델에 대한 프로그래밍 방식의 액세스를 제공합니다. 이 API는 표준 REST 아키텍처 스타일을 따르며, 예측 가능한 리소스 지향 URL을 사용하고, JSON으로 인코딩된 요청 본문을 허용합니다.

비동기 실행

모든 이미지 생성은 비동기적으로 처리됩니다. 고해상도 AI 렌더링(2k 또는 2048x2048 샘플)은 시간이 걸리며, 동기식 연결은 필연적으로 시간 초과될 것입니다.

1. 작업 제출: 입력 데이터를 포함하여 POST /v1/run 요청을 보냅니다.
2. ID 수신: API는 즉시 prediction_id와 함께 200 OK를 반환합니다.
3. 상태 폴링: 주기적으로 GET /v1/status/{predictionId}를 호출합니다.
4. 완료: 상태가 succeeded로 전환되면, 생성된 이미지의 URL이 output 배열에서 사용 가능해집니다.

기본 URL

모든 요청은 HTTPS를 통해 당사의 프로덕션 환경으로 이루어져야 합니다:

https://fititon.app/api

콘텐츠 유형

모든 POST 및 PATCH 요청에는 페이로드 형식을 지정하기 위해 다음 헤더가 포함되어야 합니다:

Content-Type: application/json

API는 또한 모든 응답을 엄격하게 JSON 형식으로 반환합니다.

웹훅

JSON 페이로드의 루트에 webhook_url을 제공하면, 비동기 작업이 완료되는 즉시 (성공하든 오류가 발생하든) 해당 URL로 HTTP POST 요청을 보냅니다.

웹훅 페이로드 예시:

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "success",
  "output": [
    "https://storage.fititon.com/results/result-123.jpg",
    "https://storage.fititon.com/results/result-124.jpg"
  ],
  "error": null,
  "created_at": "2026-07-03T10:00:00.000Z",
  "updated_at": "2026-07-03T10:00:15.000Z"
}

요청 제한 및 처리

남용을 방지하기 위해 API는 활성 개발자 플랜 등급에 따라 속도 제한을 적용합니다.

제한을 초과하면 429 Too Many Requests 오류가 발생합니다. 애플리케이션은 지수 백오프를 구현하여 이를 정상적으로 처리해야 합니다.