NSFW 영상 생성 API: Nureta Developer API 빠른 시작 가이드
읽는 데 6분
작성: Nureta Team업데이트: 2026년 10월 24일
developer.nureta.ai의 Nureta Developer API를 쓰면 내 코드에서 성인 영상을 생성할 수 있습니다. Google로 로그인하고, 계정에서 API 키를 만들고(방법은 https://developer.nureta.ai/docs), USDC로 선불 잔액을 충전한 뒤 POST /api/v3/contents/generations/tasks를 보내고, 작업을 폴링하거나 웹훅으로 결과를 받으면 됩니다. 요금은 영상 1초당 480p $0.1888, 720p $0.2773, 1080p $0.5428입니다. 이미지 없이 작성한 장면만으로 만드는 순수 텍스트-투-비디오와 동의한 성인의 참조 이미지를 최대 9장까지 쓰는 이미지-투-비디오를 지원하며, 5초 클립부터 180초의 이어 붙인 장면까지 만들 수 있습니다.
Nureta는 50,000명 이상의 사용자가 신뢰하는 No.1 무필터 NSFW AI 영상 플랫폼입니다. 텍스트 투 비디오·이미지 투 비디오, 최대 3분.
Nureta NSFW 영상 생성 API란 무엇인가요?
Nureta Developer API는 Nureta 일반 사용자용 앱을 구동하는 엔진을 개발자, 스튜디오, 앱을 위해 HTTPS로 공개한 것입니다. API 키 하나로 영상, 이미지, 대본 생성을 모두 다루며, 작업 수명 주기(생성, 폴링, 종료)도 같습니다. 영상 모델은 seahorse-480p, seahorse-720p, seahorse-1080p입니다. 5·8·10·12·15초의 단일 클립이나 16~180초의 이어 붙인 멀티샷 장면을 렌더링할 수 있고, 오디오는 기본으로 생성됩니다.
더 세밀하게 제어하려면 참조 이미지를 최대 9장 첨부하거나, first_frame 또는 last_frame을 고정하거나, 각 샷이 자체 대본, 4~15초 길이, explicit 플래그를 갖는 segments[] 스토리보드를 직접 넘길 수 있습니다. 그러면 도입 샷은 비노골적으로, 클라이맥스 샷은 노골적으로 유지할 수 있습니다. 편집 모드는 스토리보드 초안을 만들어 미리보기 이미지와 함께 planned 상태로 멈춰 두므로, 렌더링 비용을 내기 전에 비트를 수정할 수 있습니다.
API 키는 어떻게 받고, 잔액은 어떻게 충전하나요?
설정은 세 단계입니다. 먼저 developer.nureta.ai에서 Google로 로그인합니다. 다음으로 계정에서 API 키를 만듭니다(방법은 https://developer.nureta.ai/docs). 새 키는 초당 10회 요청이 기본이며 1~100 사이로 조정할 수 있습니다. 마지막으로 Billing 페이지에서 Base 네트워크의 USDC로 선불 잔액을 충전합니다. 1 USDC는 $1.00이고 카드는 필요 없습니다. 인증 정보를 따로 신청하고 기다릴 필요도 없습니다.
키는 다른 비밀 정보와 똑같이 다루세요. 환경 변수에 저장해 서버에 두고, 브라우저나 모바일 코드에 절대 넣지 말고, 유출되면 교체하세요. 모든 호출은 키를 bearer 토큰으로 인증합니다: Authorization: Bearer sk-.... 잔액이 새 작업을 감당하지 못하면 API는 나중에 청구하는 대신 AccountOverdueError를 반환합니다.
첫 요청은 어떻게 보내나요?
최소한의 5초 텍스트-투-비디오 요청은 curl 한 번이면 됩니다: curl -X POST https://developer.nureta.ai/api/v3/contents/generations/tasks -H "Authorization: Bearer sk-..." -H "Content-Type: application/json" -d '{"model":"seahorse-480p","content":[{"type":"text","text":"two adults share a slow dance in a candlelit loft"}],"duration":5}'. 응답은 {"id":"cgt-..."} 같은 작업 ID입니다.
여기서 필요에 따라 필드를 추가합니다. 이어 붙인 장면이라면 duration을 최대 180까지 설정하고, 세로 영상이라면 "ratio":"9:16"을 추가하며(16:9, 4:3, 3:4, 1:1, 21:9, adaptive도 가능), 참조 이미지로 image_url 항목을 첨부하거나, 웹훅을 받으려면 callback_url을 넘기세요. 프롬프트는 짧은 장면처럼 순서대로 쓰세요. 가상의 성인 캐릭터가 누구인지, 어디에 있는지, 무슨 일이 일어나는지를요. 키워드를 늘어놓는 것보다 명확한 문장이 더 잘 작동합니다.
완성된 영상은 어떻게 받나요?
영상은 몇 분이 걸리므로 API는 비동기입니다. status가 succeeded 또는 failed가 될 때까지 같은 bearer 키로 GET /api/v3/contents/generations/tasks/{id}를 폴링하세요. succeeded 작업에는 content.video_url이 들어 있습니다. 실행 중에는 step 객체가 진행 단계를 알려 주며(예: {"code":"rendering","done":3,"total":5}), 이것만으로 진행 표시줄을 구현할 수 있습니다. 파일은 바로 다운로드해 내 쪽에 저장하세요.
폴링은 선택 사항입니다. 작업을 만들 때 callback_url을 넘기면, 작업이 성공하거나 실패했을 때 Nureta가 완료된 작업 객체를 내 HTTPS 엔드포인트로 보냅니다. callback_secret을 추가하면 각 전송에 HMAC-SHA256 서명이 붙으므로, 신뢰하기 전에 서명을 검증하세요. 전송은 최소 1회(at-least-once) 방식이므로 작업 ID로 중복을 제거하세요. 실패한 생성은 잔액으로 자동 환불됩니다.
NSFW 영상 API 요금은 얼마인가요?
요금은 영상 1초 단위이며 선불 잔액에서 차감됩니다. 요금표: seahorse-480p는 초당 $0.1888(5초당 $0.944), seahorse-720p는 초당 $0.2773(5초당 $1.3864), seahorse-1080p는 초당 $0.5428(5초당 $2.7139)입니다. 예: 480p 60초 장면은 약 $11.33. 공개 엔드포인트 GET /api/v3/models가 현재 가격을 반환하므로, 숫자를 하드코딩하지 말고 이 값을 읽으세요.
요금은 작업 생성 시 예약되고 작업이 실패하면 환불되므로, 렌더링이 실패해도 비용은 들지 않습니다. 이는 Nureta 일반 사용자용 앱과 별개입니다. 앱은 5초 영상 1개에 $1.29를 USDC로 받고, Google 로그인 시 첫 5초 영상을 무료로 제공합니다. 고객에게 견적을 낼 때는 둘을 구분하세요. 초 단위 요금은 코드용이고, 영상 단위 요금은 nureta.ai를 쓰는 사람용입니다.
| 모델 | 해상도 | 초당 요금 | 5초당 | 단일 클립 | 이어 붙인 영상 |
|---|---|---|---|---|---|
| seahorse-480p | 480p | $0.1888 | $0.944 | 5·8·10·12·15초 | 16~180초 |
| seahorse-720p | 720p | $0.2773 | $1.3864 | 5·8·10·12·15초 | 16~180초 |
| seahorse-1080p | 1080p | $0.5428 | $2.7139 | 5·8·10·12·15초 | 16~180초 |
API는 어떤 콘텐츠를 허용하나요?
API 사용에는 Nureta 콘텐츠 정책이 적용됩니다. 성인만 허용되며, 미성년자(가상의 미성년자 포함), 본인 동의 없는 실제 인물, 공인, 비동의 콘텐츠는 금지됩니다. 공인처럼 보이는 참조 이미지는 자동으로 거부됩니다. 얼굴 사진은 사진 속 성인이 성인 콘텐츠에 동의한 경우에만 쓸 수 있고, API는 페이스 스왑이나 '옷 벗기기' 기능을 제공하지 않습니다. 위반 사항은 필요한 경우 NCMEC에 신고됩니다.
내 사용자를 위한 제품을 만든다면 이 정책은 그 사용자에게도 그대로 적용됩니다. 사용자에게 18세 이상 인증을 요구하고, 업로드하는 모든 사진에 대해 동의를 받고, 장면은 가상으로 유지하세요. SDK는 요청 시 제공되며, 모든 예제는 일반 curl로 동작하므로 HTTPS 요청을 보낼 수 있는 언어라면 무엇이든 연동할 수 있습니다.