BYGENCY 생성 API

# 1) 스튜디오에서 발급한 키를 환경변수로 둔다
export BYGENCY_API_KEY="bg_live_..."

# 2) 이미지 한 장 만들어 보기
curl -s -X POST "https://bygency.co/api/v1/generate" \
  -H "Authorization: Bearer $BYGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"image","provider":"nanobanana","model":"Nano Banana","prompt":"노을 지는 해변"}'

Authorization: Bearer bg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

curl -X POST "https://bygency.co/api/v1/generate" \
  -H "Authorization: Bearer $BYGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "image",
    "provider": "nanobanana",
    "model": "Nano Banana",
    "prompt": "네온 사인이 있는 밤거리, 시네마틱",
    "refImage": "https://example.com/ref.jpg"
  }'

# 응답
{
  "ok": true,
  "url": "https://.../result.png",
  "credits_charged": 3,
  "credits_remaining": 1997
}

curl -X POST "https://bygency.co/api/v1/generate" \
  -H "Authorization: Bearer $BYGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "video",
    "provider": "seedance",
    "model": "Seedance 2.0",
    "prompt": "질주하는 스포츠카, 해질녘 도로",
    "seconds": 5,
    "ratio": "16:9",
    "firstFrame": "https://example.com/first.jpg"
  }'

# 응답
{
  "ok": true,
  "statusUrl": "/api/generate?provider=seedance&task=...",
  "credits_charged": 15,
  "credits_remaining": 1982
}

curl "https://bygency.co/api/v1/generate?provider=seedance&task=..." \
  -H "Authorization: Bearer $BYGENCY_API_KEY"

# 진행 중
{ "status": "generating" }
# 완료
{ "status": "succeeded", "url": "https://.../video.mp4" }

curl -X POST "https://bygency.co/api/v1/chat" \
  -H "Authorization: Bearer $BYGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      { "role": "system", "content": "너는 한국어 마케팅 카피라이터다." },
      { "role": "user",   "content": "여름 세일 인스타 문구 3개" }
    ],
    "max_tokens": 800
  }'

{
  "ok": true,
  "request_id": "req_...",
  "model": "gpt-4o-mini",
  "provider": "gptchat",
  "text": "1) ...",
  "finish_reason": "stop",
  "usage": { "input_tokens": 132, "output_tokens": 418, "total_tokens": 550 },
  "cost": { "usd": 0.000271, "usd_krw": 1400, "cost_krw": 0.3794, "markup": 2.5, "credit_krw": 65 },
  "credits_charged": 0.01,
  "credits_remaining": 812.4
}

curl "https://bygency.co/api/v1/models?kind=text"

{ "ok": true, "kind": "text", "models": [
  { "model": "gpt-4o-mini", "provider": "gptchat", "unit": "token",
    "usd_per_1m_input": 0.15, "usd_per_1m_output": 0.6, "context_tokens": 128000 }, ... ] }

BASE="https://bygency.co/api/v1/generate"
KEY="$BYGENCY_API_KEY"

# 1) 이미지 — 응답에 결과 url 이 바로 담긴다
curl -s -X POST "$BASE" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"image","provider":"nanobanana","model":"Nano Banana","prompt":"노을 지는 해변"}'

# 2) 영상 — 시작하면 statusUrl 을 돌려준다 (과금은 이때 1회)
curl -s -X POST "$BASE" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"video","provider":"seedance","model":"Seedance 2.0","prompt":"질주하는 말","seconds":5}'

# 3) 상태 확인 — statusUrl 의 쿼리를 그대로 붙인다 (추가 과금 없음)
curl -s "$BASE?provider=seedance&task=TASK_ID" \
  -H "Authorization: Bearer $KEY"

curl "https://bygency.co/api/v1/credits" \
  -H "Authorization: Bearer $BYGENCY_API_KEY"

{
  "ok": true,
  "credits": 1982.5,
  "credit_price_krw": 65,
  "credits_krw": 128863,
  "plan": "Pro",
  "plan_until": "2026-12-31T00:00:00.000Z",
  "plan_active": true
}

curl -X POST "https://bygency.co/api/v1/generate" \
  -H "Authorization: Bearer $BYGENCY_API_KEY" \
  -H "Idempotency-Key: my-job-2026-08-14-0001" \
  -H "Content-Type: application/json" \
  -d '{ "model": "Seedance 2.0", "prompt": "질주하는 스포츠카", "seconds": 5 }'

# 같은 키로 다시 보내면 첫 응답을 그대로 돌려줍니다 (제공사를 다시 부르지 않습니다)
#   응답 헤더: Idempotent-Replay: true

curl "https://bygency.co/api/v1/models?kind=video"

{ "ok": true, "models": [
  { "model": "Seedance 2.0", "kind": "video", "provider": "seedance",
    "unit": "second", "usd_per_unit": 0.343 } ] }

curl -X POST "https://bygency.co/api/v1/cancel" \
  -H "Authorization: Bearer $BYGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "task": "/api/generate?provider=seedance&task=..." }'

{ "ok": true, "stopped": true, "credits_refunded": 12.5 }

curl "https://bygency.co/api/v1/usage?limit=50" \
  -H "Authorization: Bearer $BYGENCY_API_KEY"

{ "ok": true,
  "usage": [ { "model": "Seedance 2.0", "kind": "video", "credits": 10,
               "status": "ok", "task": "...", "created_at": "2026-08-14T…" } ],
  "totals": { "calls": 3, "credits": 12.5, "ok": 2, "failed": 1 },
  "next_cursor": "2026-08-14T…" }

curl -X POST "https://bygency.co/api/v1/webhook" \
  -H "Authorization: Bearer $BYGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://내서버.example.com/bygency-callback" }'

{ "ok": true, "registered": true, "secret": "whsec_..." }
# 시험 발송:  -d '{ "test": true }'      해제:  -X DELETE

import crypto from 'node:crypto'

app.post('/bygency-callback', express.raw({ type: '*/*' }), (req, res) => {
  const ts  = req.header('X-Bygency-Timestamp')
  const sig = req.header('X-Bygency-Signature')          // "sha256=<hex>"
  const raw = req.body.toString('utf8')                   // ⚠ 원본 그대로

  // 지나간 요청을 그대로 다시 보내는 공격을 막습니다
  if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return res.sendStatus(400)

  const mine = 'sha256=' + crypto.createHmac('sha256', process.env.BYGENCY_WEBHOOK_SECRET)
    .update(ts + '.' + raw).digest('hex')
  if (mine !== sig) return res.sendStatus(401)

  const { event, data } = JSON.parse(raw)
  // event: "generation.succeeded" | "generation.failed"
  res.sendStatus(200)   // 2xx 를 주면 재시도하지 않습니다
})

curl "https://bygency.co/api/v1/openapi.json" -o bygency.json

# 클라이언트 자동 생성 (예: TypeScript)
npx @openapitools/openapi-generator-cli generate \
  -i bygency.json -g typescript-fetch -o ./bygency-client

curl -X POST https://nextbygency.com/api/v1/controlnet \
  -H "Authorization: Bearer bg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "눈 내리는 골목의 검은 고양이, 시네마틱",
    "type": "canny",
    "image_url": "https://example.com/ref.png",
    "strength": 0.8,
    "ratio": "16:9"
  }'

curl https://nextbygency.com/api/v1/models
# → { models: [{ id:"sr-x4-fast", title, license, files, lease_credits }] }