본문으로 건너뛰기

개발자 용어집

연동 전에 API 용어부터 이해하세요.

모델 선택, 작업 상태 처리, 콜백 검증, 사용량 예상과 사용자 자료 보호에 필요한 개념을 실무적으로 설명합니다.

01

비동기 생성 API

정의

미디어 요청을 받고 지속 taskId를 반환한 뒤 원래 HTTP 요청 밖에서 작업을 완료하는 API입니다.

구현 메모

폴링이나 Webhook 대기 전에 taskId를 저장하세요. queued와 running은 진행 중이고 succeeded·failed·expired는 최종 상태입니다. 수락된 작업은 취소할 수 없습니다.

관련 페이지 →
02

멱등성 키

정의

재전송을 하나의 논리 작업으로 처리해 중복 과금 작업 생성을 막는 클라이언트 ID입니다.

구현 메모

동일한 검증 요청에만 같은 키를 쓰고 작업과 함께 저장해 재시도 시 원래 결과를 반환하세요.

관련 페이지 →
03

Webhook 서명

정의

콜백이 API에서 왔고 전송 중 변경되지 않았음을 확인하는 암호 값입니다.

구현 메모

원본 본문을 검증하고 오래된 타임스탬프를 거부하며 상태 변경 전 eventId를 중복 제거하세요.

관련 페이지 →
04

모델 스키마

정의

모델 입력 필드, 타입, 제한, 기본값과 출력 구조를 설명하는 기계 판독 사양입니다.

구현 메모

공개 스키마에서 폼과 서버 검증을 만들고 각 작업에 사용된 버전을 기록하세요.

관련 페이지 →
05

참조 이미지

정의

이미지·비디오 생성에서 정체성, 구도, 스타일 또는 움직임을 유도하는 입력 이미지입니다.

구현 메모

출처와 동의를 기록하고 형식을 검증하세요. 참조 이미지는 실제 인물 복제 허가가 아닙니다.

관련 페이지 →
06

사용량 기반 요금

정의

실제 사용량에 따라 비용을 계산하는 방식입니다. 모델별로 이미지 1장, 출력 1초, 메가픽셀, 토큰 또는 요청 같은 적용 단위를 안내합니다.

구현 메모

제출 전에 적용 단위와 실행 전 예상 비용을 보여 주세요. 최소 요금, 길이와 출력 수에 따라 최종 비용이 달라질 수 있습니다.

관련 페이지 →
07

콘텐츠 필터가 적은 AI 모델

정의

필터가 적은 개별 모델 옵션입니다. 이 표시는 제품 정보이며 플랫폼 승인이 아닙니다.

구현 메모

요청 전 사용자와 서비스에 필요한 연령, 동의, 실제 인물, 관할 통제를 자체 앱에서 구현하세요.

관련 페이지 →

모델 연동을 시작할까요?

입력 항목, 예시와 현재 가격을 확인하고 실제 설정으로 실행 전 예상 비용을 살펴보세요.