Question 1

BYGENCY 를 쓰려면 프로그래밍을 알아야 하나요?

Accepted Answer

아닙니다. 노드 스튜디오는 마우스로 블럭을 잇는 화면이라 코드가 필요 없습니다. API 와 MCP 는 개발자나 AI 에이전트를 위한 추가 창구입니다.

Question 2

어떤 AI 모델을 쓸 수 있나요?

Accepted Answer

Google Veo, Runway, Seedance, Kling, Luma, MiniMax(Hailuo), Flux, Nano Banana, GPT Image 등 영상·이미지 모델을 한 계정에서 고를 수 있습니다. 지금 실제로 켜져 있는 전체 목록은 홈 화면 맨 아래 "지금 연결되어 작동 중인 모델" 과 GET /api/v1/models 에서 확인합니다.

Question 3

무료로 써 볼 수 있나요?

Accepted Answer

가입은 무료이고, 실제로 생성한 만큼만 크레딧으로 정산합니다. 요금제는 [요금제 안내](/pricing)에서 확인하세요.

Question 4

프롬프트는 한국어로 써도 되나요?

Accepted Answer

됩니다. 한국어 프롬프트를 그대로 받습니다. 다만 카메라 움직임·조명 같은 영상 용어는 영어를 섞는 편이 결과가 안정적입니다.

Question 5

결과가 마음에 안 들면 크레딧이 돌아오나요?

Accepted Answer

"마음에 안 든다" 로는 돌아오지 않습니다. 다만 제작이 실패했거나 취소한 경우에는 자동으로 환불됩니다. 자세한 내용은 [크레딧은 언제 돌아오나요](/support?a=credit-refunds) 문서를 보세요.

Question 6

같은 결과를 다시 뽑고 싶습니다.

Accepted Answer

시드(seed) 값을 고정하세요. 같은 시드 + 같은 프롬프트 + 같은 설정이면 같은 결과가 나옵니다.

Question 7

스튜디오에서 만든 것과 API 로 만든 것의 요금이 다른가요?

Accepted Answer

다르지 않습니다. 모델·길이·해상도가 같으면 청구되는 크레딧도 같습니다.

Question 8

API 를 쓰려면 별도 요금제가 필요한가요?

Accepted Answer

노드형 AI 영상 플랜이 있어야 합니다. 플랜이 없으면 생성 호출이 403 forbidden 으로 거부됩니다. 잔액과 플랜 상태는 GET /api/v1/credits 로 확인합니다.

Question 9

선이 안 이어집니다.

Accepted Answer

두 점의 종류가 다른 경우입니다. 이미지 출력을 영상 입력에 바로 꽂을 수는 없고, 영상 생성 블럭의 "첫 프레임" 입력처럼 이미지를 받는 자리에 꽂아야 합니다.

Question 10

작업한 내용은 저장되나요?

Accepted Answer

자동으로 저장됩니다. 브라우저를 닫았다 열어도 캔버스가 그대로 남습니다.

Question 11

블럭을 몇 개까지 놓을 수 있나요?

Accepted Answer

요금제마다 최대 노드 수가 다릅니다. 내 한도는 대시보드와 [요금제 안내](/pricing)에서 확인합니다.

Question 12

미리보기가 안 나옵니다.

Accepted Answer

참조 이미지가 아직 안 올라갔거나, 인물이 아닌 사진에 Pose 를 건 경우입니다. Pose 는 사람이 보이는 사진에서만 자세를 잡아냅니다.

Question 13

ControlNet 을 쓰면 요금이 오르나요?

Accepted Answer

제어를 거는 만큼 처리가 늘어나 가산이 붙습니다. 실제로 청구된 값은 생성이 끝난 뒤 블럭과 사용 내역에서 확인할 수 있습니다.

Question 14

슬라이더를 움직였는데 결과가 그대로입니다.

Accepted Answer

먼저 패널의 "프롬프트에 이렇게 붙습니다" 상자를 확인하세요. 상자가 없으면 값이 전부 0 이라 아무것도 안 붙은 것입니다. 상자에 문장이 보이는데도 결과가 비슷하다면, 프롬프트가 그 각도와 어긋나는 장면을 지시하고 있을 수 있습니다(예: "정면 클로즈업" 이라고 적어 두고 90도 회전).

Question 15

시드 칸이 안 보입니다.

Accepted Answer

그 모델이 시드를 받지 않는다는 뜻입니다 — 두 화면 모두 같은 기준으로 칸을 엽니다. 시드를 고정해서 같은 그림을 다시 뽑아야 한다면, 모델 목록에서 시드 칸이 열리는 모델로 바꿔 주세요(칸이 사라지면 그 자리에 이유가 적힙니다).

Question 16

LoRA 강도를 올렸는데 달라지지 않습니다.

Accepted Answer

LoRA ID 칸이 비어 있으면 강도는 쓰이지 않습니다. 따로 학습시킨 파인튜닝이 없다면 두 칸 모두 비워 두시면 됩니다 — 고른 모델 그대로 생성됩니다.

Question 17

가상 피팅에는 촬영각이 안 보입니다.

Accepted Answer

가상 피팅은 설명(프롬프트)을 아예 받지 않고 사진 두 장의 순서(첫째 인물 · 둘째 옷)가 곧 지시인 모델입니다. 각도는 넣어 주신 인물 사진의 각도를 그대로 따라갑니다. 각도를 바꾸려면 다른 이미지 모델로 원하는 각도의 인물 사진을 먼저 만든 뒤 그것을 넣어 주세요.

Question 18

요금이 더 드나요?

Accepted Answer

생성 단계 수를 올려도 이미지는 장당 같은 값으로 청구됩니다. 촬영각도 프롬프트에 문장이 붙을 뿐이라 추가 요금이 없습니다.

Question 19

API 나 Claude(MCP)에서도 쓸 수 있나요?

Accepted Answer

됩니다. 공개 API 는 imgCam · steps · guidance · lora · loraStrength 로 받고(자세한 값은 [API 문서](/docs/api) 참고), MCP 의 generate_image 도구는 camera · steps · guidance · lora · lora_scale 로 받습니다.

Question 20

지금 쓸 수 있는 모델 전체 목록은 어디서 보나요?

Accepted Answer

홈 화면 맨 아래 "지금 연결되어 작동 중인 모델" 목록, 그리고 GET https://nextbygency.com/api/v1/models 에서 봅니다. 이 목록은 관리자가 실제로 켠 모델만 담습니다.

Question 21

모델 이름을 API 에 그대로 넣으면 되나요?

Accepted Answer

네. 화면에 보이는 표시명이 그대로 model 값입니다. 정확한 철자는 GET /api/v1/models 응답을 복사해 쓰세요.

Question 22

키를 잃어버렸습니다.

Accepted Answer

전체 값은 발급 순간에만 보여 줍니다. 다시 볼 수 없으므로 새 키를 발급하고 옛 키를 지우세요.

Question 23

키 하나로 여러 서비스에서 써도 되나요?

Accepted Answer

가능하지만 권하지 않습니다. 서비스별로 키를 따로 발급해 두면 문제가 생겼을 때 그 키만 지울 수 있습니다.

Question 24

401 unauthorized 가 계속 나옵니다.

Accepted Answer

헤더 형식을 확인하세요 — Authorization: Bearer bg_live_... 입니다. Bearer 와 키 사이에 공백 하나가 필요하고, 키 앞뒤 공백이나 줄바꿈이 섞이면 거부됩니다.

Question 25

영상이 다 됐는지 어떻게 아나요?

Accepted Answer

statusUrl 을 주기적으로 조회하거나, [웹훅](/support?a=webhook-setup)을 걸어 두면 완료 시점에 우리가 먼저 알려 드립니다. 웹훅 쪽이 호출 수도 적고 빠릅니다.

Question 26

몇 초짜리를 만들 수 있나요?

Accepted Answer

모델마다 다릅니다. 대개 5초·8초·10초 중에서 고르며, 안 받는 값을 주면 가장 가까운 값으로 맞춰집니다.

Question 27

기계가 읽는 규격서가 있나요?

Accepted Answer

있습니다. GET https://nextbygency.com/api/v1/openapi.json 이 OpenAPI 3.1 규격서를 돌려줍니다. 이 규격서는 실제 코드의 오류 코드와 모델 표에서 그때그때 만들어지므로 코드와 어긋나지 않습니다.

Question 28

응답에 원가(USD)가 안 보입니다.

Accepted Answer

의도한 것입니다. 응답에는 credits_charged(이번에 빠진 크레딧)와 credits_remaining(남은 크레딧)만 담습니다 — 그 두 값이 실제로 청구된 금액입니다. 원화로 환산하려면 GET /api/v1/credits 의 credit_price_krw 를 곱하세요. 재판매하신다면 그 값이 원가 기준입니다.

Question 29

답이 비어 있으면 크레딧이 빠지나요?

Accepted Answer

아니요. 제공사가 빈 글을 주거나 실패하면 502 로 답하고 한 푼도 차감하지 않습니다.

Question 30

Gemini 를 불렀는데 자꾸 빈 글이 옵니다.

Accepted Answer

2.5 계열은 답을 쓰기 전에 생각(thinking) 하고, 그 생각도 max_tokens 를 씁니다. 상한이 작으면 생각만 하다 끝나 글이 한 자도 안 나옵니다(finish_reason: MAX_TOKENS). max_tokens 를 넉넉히(예: 2048) 주거나 thinking_budget: 0 으로 생각을 끄세요. 이 경우에도 크레딧은 차감되지 않습니다.

Question 31

재시도가 두 번 청구되지 않게 하려면?

Accepted Answer

Idempotency-Key 헤더를 붙이세요. 같은 키로 다시 보내면 제공사를 다시 부르지 않고 첫 응답을 그대로 돌려줍니다.

Question 32

Gemini 는 어느 경로로 나가나요?

Accepted Answer

둘 중 열려 있는 쪽으로 나갑니다 — AI Studio 키(GEMINI_API_KEY)가 있으면 그쪽, 없거나 인증이 막히면 Vertex AI(서비스계정 JSON, Veo·Imagen 과 같은 자격)로 갑니다. 어느 문으로 나갔는지는 관리자 [채팅 모델 점검] 결과에 그대로 표시됩니다. 부르는 쪽에서 할 일은 없습니다 — 요청 모양과 과금 규칙은 두 경로가 같습니다.

Question 33

실수로 /api/v1/generate 로 보냈습니다.

Accepted Answer

그대로 처리됩니다. 채팅 모델 이름(gpt-4o-mini 등)이 실려 있으면 생성 창구가 채팅 창구로 넘겨 같은 응답을 돌려주고, 값도 채팅 규칙으로 한 번만 차감합니다. 모델 이름이 채팅 목록에 없으면 400 과 함께 see: "/api/v1/chat" 로 갈 곳을 알려 드립니다.

Question 34

MCP(Claude 커넥터)로도 채팅을 부를 수 있나요?

Accepted Answer

아니요. MCP 도구는 영상·이미지·음악 생성과 모델 대여까지입니다. 채팅은 REST(POST /api/v1/chat)로만 제공합니다.

Question 35

대화 기록은 저장되나요?

Accepted Answer

보내신 글 자체는 저장하지 않습니다. 호출 기록에는 모델·토큰 수·글자 수·값만 남습니다.

Question 36

얼마나 자주 조회해도 되나요?

Accepted Answer

조회는 분당 120회, 시간당 3000회까지 받습니다. 그래도 완료를 기다리는 목적이라면 웹훅을 권합니다 — 호출도 아끼고 지연도 없습니다.

Question 37

취소했는데 크레딧이 0 으로 돌아왔습니다.

Accepted Answer

결과가 이미 전달된 작업이거나, 이미 환불된 작업입니다. 같은 작업은 두 번 환불되지 않습니다.

Question 38

429 가 났는데 얼마나 기다려야 하나요?

Accepted Answer

응답의 Retry-After 헤더가 기다릴 초를 알려 줍니다. X-RateLimit-Limit · X-RateLimit-Remaining · X-RateLimit-Reset 헤더도 함께 오므로, 한도에 닿기 전에 미리 속도를 줄일 수 있습니다.

Question 39

402 가 났을 때 얼마가 모자란지 알 수 있나요?

Accepted Answer

응답에 need(필요한 크레딧)와 have(가진 크레딧)가 함께 옵니다.

Question 40

provider_error 는 우리 잘못인가요?

Accepted Answer

아닙니다. 모델 제공사 쪽에서 실패한 경우입니다. 이때는 크레딧이 자동으로 정리됩니다 — [크레딧은 언제 돌아오나요](/support?a=credit-refunds)를 보세요.

Question 41

재시도하면 두 번 청구되나요?

Accepted Answer

Idempotency-Key 를 붙였다면 아닙니다. 같은 키의 재시도는 첫 결과를 그대로 돌려주고 다시 청구하지 않습니다(24시간).

Question 42

동시 3개 제한을 늘릴 수 있나요?

Accepted Answer

대량 처리가 필요하면 [문의](/contact)를 남겨 주세요. 사용 형태를 보고 안내해 드립니다.

Question 43

잘 연결됐는지 미리 시험해 볼 수 있나요?

Accepted Answer

{ "test": true } 로 요청하면 시험용 요청을 실제로 한 번 보냅니다. 받는 쪽 로그에서 서명 검증까지 확인해 보세요.

Question 44

웹훅을 지우려면?

Accepted Answer

같은 주소로 DELETE 요청을 보내면 등록이 해제됩니다.

Question 45

알림이 안 옵니다.

Accepted Answer

받는 서버가 https 인지, 2xx 를 돌려주는지, 방화벽이 우리 요청을 막고 있지 않은지 확인하세요. 전달 이력은 우리 쪽에 남으므로 request_id 와 함께 [문의](/contact)해 주시면 확인해 드립니다.

Question 46

크레딧 단가가 사람마다 다른가요?

Accepted Answer

다를 수 있습니다. 그래서 화면에 금액을 표시할 때는 표에 적힌 기본값이 아니라 credit_price_krw 로 계산해야 합니다.

Question 47

이력에 실패한 호출도 나오나요?

Accepted Answer

나옵니다. status=failed 로 걸러 볼 수 있고, 각 줄에 왜 실패했는지가 함께 담깁니다.

Question 48

토큰이 노출되면 어떻게 하나요?

Accepted Answer

대시보드에서 토큰을 다시 발급하세요. 옛 토큰은 즉시 막힙니다.

Question 49

MCP 로 만든 것도 같은 크레딧에서 빠지나요?

Accepted Answer

같은 계정, 같은 크레딧입니다. 사용 내역도 GET /api/v1/usage 에 함께 남습니다.

Question 50

API 호출 한도가 MCP 에도 적용되나요?

Accepted Answer

적용됩니다. 생성 도구는 생성 한도로, 조회 도구는 조회 한도로 셉니다. AI 에이전트가 반복 호출로 크레딧을 소진하는 것을 막기 위한 장치입니다.

Question 51

AI 가 마음대로 비싼 모델을 쓰면 어쩌죠?

Accepted Answer

프롬프트에 쓸 모델을 명시하거나, list_models 로 먼저 목록을 보게 한 뒤 고르게 하세요. 한도(동시 3개·분당 60회)도 그대로 걸리므로 한 번에 크게 새지 않습니다.

Question 52

만들어진 영상 파일은 어디에 있나요?

Accepted Answer

생성 결과 URL 로 옵니다. 보관함에도 함께 남습니다.

Question 53

만들기 전에 얼마 나갈지 알 수 있나요?

Accepted Answer

노드 스튜디오는 실행 전에 예상 크레딧을 보여 줍니다. MCP 는 dry_run: true 로 실제 호출 없이 확인할 수 있습니다.

Question 54

실패한 생성도 청구되나요?

Accepted Answer

아닙니다. 실패는 자동으로 정리되어 크레딧이 돌아옵니다 — [크레딧은 언제 돌아오나요](/support?a=credit-refunds)를 보세요.

Question 55

조회만 하는 호출도 크레딧을 쓰나요?

Accepted Answer

쓰지 않습니다. 잔액 조회, 사용 내역, 모델 목록, 상태 확인은 무료입니다.

Question 56

환불된 것을 어떻게 확인하나요?

Accepted Answer

GET /api/v1/usage 이력에서 해당 호출의 상태로 확인할 수 있고, 대시보드 사용 내역에도 남습니다.

Question 57

취소했는데 0 크레딧이 돌아왔습니다.

Accepted Answer

결과가 이미 전달됐거나 이미 환불된 작업입니다.

Question 58

결제한 금액 자체를 환불받고 싶습니다.

Accepted Answer

크레딧 환불과 결제 환불은 다릅니다. 결제 건은 [문의](/contact)로 요청해 주세요.

Question 59

요금제와 크레딧은 다른 건가요?

Accepted Answer

다릅니다. 요금제는 쓸 수 있는 기능과 한도를 정하고, 크레딧은 실제로 생성한 만큼 빠집니다.

Question 60

API 를 쓰려면 어떤 요금제가 필요한가요?

Accepted Answer

노드형 AI 영상 플랜이 필요합니다. 없으면 생성 호출이 403 forbidden 으로 거부됩니다.

Question 61

자세한 가격은 어디서 보나요?

Accepted Answer

[요금제 안내](/pricing)에 등급별 제공 크레딧과 최대 노드 수가 정리돼 있습니다.

Question 62

예약을 걸어 둔 뒤 시간대를 바꾸면 어떻게 되나요?

Accepted Answer

이후 실행부터 새 시간대 기준으로 계산됩니다. 예약한 "오전 9시" 라는 표시는 그대로 두고, 그 9시가 어느 순간인지가 바뀝니다.

Question 63

예약이 정확히 그 시각에 도나요?

Accepted Answer

예약 처리는 1분 주기로 돌기 때문에 분 단위로 맞습니다.

Question 64

예약한 시각에 크레딧이 부족하면 어떻게 되나요?

Accepted Answer

실행이 실패로 남고 크레딧은 빠지지 않습니다. 충전 후 다시 예약하세요.