API 설정

Fit-it-on 개발자 API와 상호작용하려면 보안 개발자 API 키를 사용하여 요청을 인증해야 합니다.

API 키 생성

Fit-it-on 대시보드에 로그인합니다.
왼쪽 사이드바에서 개발자 > API 키로 이동합니다.
새 키 생성 버튼을 클릭합니다.
새 비밀 키를 복사합니다 (항상 fio_sk_...로 시작합니다).

이 키를 안전하게 보관하세요! 보안상의 이유로, 생성 대화 상자를 닫은 후에는 이 키를 다시 볼 수 없습니다. 키를 분실한 경우, 키를 폐기하고 새 키를 생성해야 합니다.

인증

모든 API 요청에는 Authorization 헤더에 Bearer 토큰으로 API 키가 포함되어야 합니다.

curl https://fititon.app/api/v1/run \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "tryon",
    "inputs": { ... }
  }'

비동기 워크플로우

Fit-it-on 생성 엔드포인트(예: /v1/run)는 비동기적으로 작동합니다. 이는 초기 요청이 생성이 완료될 때까지 기다리지 않고 작업 추적 ID와 함께 즉시 반환됨을 의미합니다.

1단계: 작업 제출

생성 작업을 대기열에 추가하려면 https://fititon.app/api/v1/run으로 POST 요청을 하세요. 즉시 응답을 받게 됩니다:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

2단계: 결과 폴링

반환된 id를 사용하여 https://fititon.app/api/v1/status/{id}로 GET 요청을 하여 생성 상태를 주기적으로 확인하세요.

curl https://fititon.app/api/v1/status/123a87r9-4129-4bb3-be18-9c9fb5bd7fc1 \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY"

응답은 작업의 현재 상태를 나타냅니다. status가 "completed"일 때, output 필드에는 생성된 이미지 또는 비디오의 URL이 포함됩니다.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "completed",
  "output": [
    "https://cdn.fititon.app/users/123/results/result-123.png"
  ],
  "error": null,
  "created_at": "2026-07-17T11:00:00.000Z",
  "updated_at": "2026-07-17T11:00:25.000Z"
}

첫 번째 요청 보내기

현재 남은 개발자 크레딧을 가져오고 요금제를 확인하여 키를 테스트할 수 있습니다:

curl https://fititon.app/api/v1/credits \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY"

성공하면 현재 요금제와 남은 크레딧이 포함된 JSON 객체가 반환됩니다.