NSFW AI API: 내 코드에서 직접 성인용 이미지와 영상 생성하기

성인용 제품, 컴패니언 앱, 아트 도구, 또는 개인용 생성기를 만들고 있다면 스튜디오가 쓰는 것과 같은 모델을 여러분의 코드에서 직접 호출할 수 있습니다. 이 글은 특히 NSFW 콘텐츠로 그 작업을 할 때의 체크리스트입니다. API가 허용하는 것, 거부를 알리는 방식, 그리고 우리가 아닌 여러분의 몫인 부분을 다룹니다. 키, 엔드포인트, 모델별 바로 쓸 수 있는 요청 같은 일반적인 사용법은 API 페이지에 있습니다.

1. API가 허용하는 범위 알기

API는 스튜디오와 토씨 하나 다르지 않은 같은 이용약관을 따릅니다. 성인 간의 성인 콘텐츠는 허용됩니다. 어떤 경우에도 허용되지 않는 것이 세 가지 있습니다. 미성년자나 연령 역할극이 포함된 성적 콘텐츠, 비동의를 묘사하는 콘텐츠, 그리고 실제로 식별 가능한 인물의 성적이거나 은밀한 이미지입니다. 여기에 더해 각 모델은 자체 모더레이션을 갖춘 공급자에서 실행되며, 일부 모델은 성인용 프롬프트를 아예 거부합니다.

API가 반환하는 모델 목록에는 성인용 플래그가 없습니다. 카탈로그에 없는 것과 같은 이유입니다. 공급자는 규칙을 바꾸고, 우리가 정확하게 유지할 수 없는 플래그는 오히려 오해를 낳습니다. 사용할 계획인 모델마다 명백히 성인용인 요청을 하나씩 보내 테스트하고, 통과한 모델로 목록을 만드세요. NSFW 이미지 모델 가이드에서 그 테스트를 설명합니다.

2. 두 종류의 거부 처리하기

여러분의 코드는 두 곳에서 오는 거부를 만나게 되며, 각각 다르게 도착합니다.

• 우리의 사전 검사, 동기적으로. 요청의 모든 자유 입력 필드는 과금 전에 검사됩니다. 미성년자가 포함된 프롬프트는 즉시 PROMPT_REJECTED_MINOR 코드와 함께 400으로 돌아오고, 성폭력이나 고어는 PROMPT_REJECTED_VIOLENCE로 돌아옵니다. 렌더링은 생성되지 않고 잔액도 그대로입니다.
• 공급자, 나중에. 요청이 수락되어 과금되고 렌더링이 시작된 뒤 공급자가 거부하는 경우입니다. 폴링하면 렌더링이 refunded: true와 실패 코드 MODERATION_REJECTED로 끝나며, 요금은 이미 잔액으로 돌아와 있습니다.

첫 번째는 최종 결정으로 취급하세요. 재시도하지 말고, 자동으로 문구를 바꿔 다시 보내지도 마세요. 두 번째는 모델에 대한 신호로 취급하세요. 같은 모델에 같은 입력을 재시도하면 보통 같은 방식으로 실패하므로, 테스트를 통과한 목록의 다음 모델로 보내거나 이 모델이 거부했다고 사용자에게 분명히 알리세요.

프롬프트에는 사람을 소개하듯 나이를 적으세요. "30대 여성", "40대 남성"처럼요. 이미지나 영상 프롬프트가 전송되기 전에 "girl"이나 "boy" 같은 단어는 성인 표현으로 다시 쓰이므로, 처음부터 "성인 여성"이라고 쓴 프롬프트가 사용자가 요청한 것에 더 가깝게 렌더링됩니다.

3. 여러분 몫의 검사 추가하기

우리의 사전 검사는 최소 기준이지 여러분의 모더레이션이 아닙니다. 이용약관은 여러분의 사용자가 만든 것을 포함해 여러분의 키로 생성된 모든 것에 대한 책임을 키 소유자에게 두며, 서비스를 법정 성인에게만 제한하도록 요구합니다. 실제로는 다음을 의미합니다.

1. 01연령 확인 게이트를 성인 콘텐츠를 생성하는 모든 기능 앞에, 첫 요청 이후가 아니라 이전에 두세요.
2. 02자체 프롬프트 검사를 우리를 호출하기 전에 두어, 금지된 내용을 입력한 사용자가 여러분 쪽에서 차단되고 기록되게 하세요. 우리의 거부 코드는 첫 번째가 아니라 두 번째 방어선입니다.
3. 03성인용 흐름에 실제 인물 업로드 금지. 앱이 시작 프레임이나 참조 이미지를 받는다면, 결과가 성적일 때 식별 가능한 인물의 사진이 들어가지 않게 하세요.
4. 04누가 무엇을 요청했는지의 기록을 여러분의 사용자 id에 연결해 두어, 문제가 생겼을 때 올바른 계정에 조치할 수 있게 하세요.

4. 결제, 키, 파일

• 잔액은 하나. API 렌더링은 스튜디오와 같은 잔액에서 같은 가격으로, 유로 센트 단위로 결제됩니다. 최소 충전 금액은 €5.00입니다.
• 멱등성. 모든 생성 호출에 Idempotency-Key 헤더를 보내면 네트워크 재시도로 두 번 과금되는 일이 없습니다.
• 키는 서버에만. 키는 gl_live_로 시작하고 한 번만 표시되며, 서버 측 비밀 저장소에 두어야 합니다. 브라우저나 앱 번들에는 절대 넣지 마세요. 유출되면 설정에서 폐기하세요.
• 바로 다운로드. 완료된 파일은 보관 기간이 지나면 삭제되므로, 렌더링이 성공하는 즉시 결과를 여러분의 저장소로 복사하세요.

영상도 API를 통해 같은 방식으로 작동합니다. 성인용 정지 이미지 애니메이션에 대한 안내가 그대로 적용되며, 영상 모델이 이미지 모델보다 더 자주 거부하는 이유도 거기에 있습니다.