bn-router

이미지 · 비디오 API

통합 엔드포인트를 통해 OpenAI 호환 이미지 형식으로 이미지와 비디오를 생성합니다.

엔드포인트

이미지 생성과 비디오 생성은 단일 엔드포인트를 공유합니다. 프롬프트와 함께 POST 요청을 보내면 게이트웨이가 최적의 업스트림 계정으로 라우팅합니다.

Endpoint
POST https://YOUR-BASE-URL/v1/images/generations

이미지 생성

텍스트 설명에서 이미지를 생성합니다. 요청은 OpenAI images/generations 형식을 따릅니다. Flux Pro, DALL·E 3, Stable Diffusion 3 등을 동일한 엔드포인트에서 이용할 수 있습니다.

model을 모델 플라자의 이미지 모델 ID로 설정합니다. 응답에는 생성된 이미지 URL이 하나 이상 포함됩니다.

curl
curl https://YOUR-BASE-URL/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-pro",
    "prompt": "A serene mountain lake at sunrise, photorealistic",
    "n": 1,
    "size": "1024x1024"
  }'

이미지 편집

마스크와 새 프롬프트를 제공하여 기존 이미지를 편집합니다. 이미지, 마스크, 프롬프트 필드가 포함된 multipart/form-data 요청을 보내세요.

인페인팅을 지원하는 모델만 편집을 허용합니다. 편집 가능 모델은 모델 플라자에서 확인하세요.

curl
curl https://YOUR-BASE-URL/v1/images/edits \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "image=@./input.png" \
  -F "mask=@./mask.png" \
  -F "prompt=Replace the background with a futuristic cityscape" \
  -F "n=1" \
  -F "size=1024x1024"

비디오 생성

텍스트 또는 이미지 프롬프트에서 짧은 비디오를 생성합니다. 동일한 엔드포인트와 인증이 비디오 모델에서도 작동합니다. 비디오 생성의 계산 비용으로 인해 응답 시간이 더 깁니다.

비디오 지원은 빠르게 확장 중입니다. 최신 비디오 모델은 모델 플라자에서 확인하세요.

curl
curl https://YOUR-BASE-URL/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "A cinematic aerial view of a futuristic city at night",
    "n": 1,
    "size": "1920x1080"
  }'

사용량 및 요금

이미지 및 비디오 요청은 모델 플라자에 표시된 요율로 생성당 청구됩니다. 이미지 크기, 품질(hd/standard), 요청 이미지 수가 토큰 비용에 영향을 미칩니다.

사용량은 텍스트 완성과 함께 대시보드에서 추적되어 게이트웨이의 모든 활동을 한눈에 볼 수 있습니다.