콘텐츠로 건너뛰기
FreshApp Demo

오픈 API

내 코드에서 생성하기

내 서버에서 사이트의 모델을 사용하세요. API 키로 생성 작업을 만들고, 끝날 때까지 따라간 다음, 파일을 내려받습니다.

API 문서 보기API 키 관리

API는 유료 크레딧만 사용합니다. 유료 크레딧 팩이나 활성 유료 구독이 있으면 쓸 수 있습니다. 키는 서버에만 두세요.

요청 예시

첫 생성 작업 만들기

export API_ORIGIN='https://demo.freshapp.ai'
export API_KEY='sk_YOUR_API_KEY'

curl --fail-with-body "$API_ORIGIN/api/v1/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: order-1001' \
  -d '{"model":"seed-audio-1.0","input":{"prompt":"새벽녘 절벽 위의 등대, 잔잔한 바다, 부드러운 빛."}}'

# Read it every 5 to 10 seconds until its status ends.
curl --fail-with-body "$API_ORIGIN/api/v1/generations/GENERATION_ID" \
  -H "Authorization: Bearer $API_KEY"

# A delivered output's url is a signed link: no key needed.
curl --fail-with-body -o result "OUTPUT_URL"

먼저 API_KEY에 키를 설정하세요. 새 요청마다 새 Idempotency-Key를 보내고, 같은 요청을 다시 보낼 때는 같은 키를 사용합니다.

작동 방식

요청부터 파일까지 세 단계

  1. 생성 작업 만들기

    API 키와 Idempotency-Key를 붙여 모델 ID와 입력을 보냅니다. 응답은 대기열에 들어간 생성 작업과 그 작업이 잡아 둔 크레딧입니다.

  2. 진행 확인하기

    성공, 부분 성공, 실패, 취소 중 하나가 될 때까지 5~10초마다 작업을 조회합니다. 쓰지 않은 크레딧은 정산할 때 돌아옵니다.

  3. 파일 내려받기

    전달된 출력마다 이 사이트의 파일로 연결됩니다. 키로 받은 링크는 서명되어 있어 1시간 동안 키 없이 열 수 있습니다.

권한과 한도

허용한 일만 하는 키

  • 키는 읽기만 하거나(목록, 조회, 다운로드) 생성까지 할 수 있습니다(생성과 취소). IP 허용 목록으로 내 서버에서만 쓰이게 할 수도 있습니다.

  • 요청 한 번에 잡아 둘 수 있는 크레딧은 최대 150이며, 활성 모델 중 가장 비싼 요청의 가격입니다. 키 설정이나 요청의 max_credits로는 낮추기만 할 수 있습니다.

  • 키 하나는 UTC 기준 하루에 최대 5,000 크레딧, 계정의 모든 키를 합쳐 최대 10,000 크레딧을 씁니다. API 키 페이지에서 다른 한도를 정할 수 있습니다.

  • 키마다, 계정마다 1분에 생성·취소 20번, 조회·다운로드 240번까지이며, 동시에 실행되는 작업은 최대 2개입니다.

파일

OpenAPI 파일과 TypeScript 클라이언트

OpenAPI 3.1 파일에는 모든 작업, 활성 모델별 입력, 모든 오류 코드가 있습니다. TypeScript 클라이언트는 다른 패키지가 필요 없고, 재시도 내내 같은 Idempotency-Key를 유지하며 생성 작업을 끝까지 따라갑니다. React 훅은 이 클라이언트로 폴링합니다.

API 문서 보기OpenAPI 3.1 파일TypeScript 클라이언트React 폴링 훅

자주 묻는 질문

API에 관한 질문