출처: Dev.to

https://dev.to/useapi

Introduction

Veo 3.1, Google의 주요 비디오 모델은 useapi.net(https://useapi.net/docs/subscription)를 통해 단일 curl 명령으로 실행됩니다. 자체 Google Flow(https://labs.google/fx/tools/flow) 계정을 사용하므로 Google Cloud 프로젝트나 엔터프라이즈 승인이 필요 없으며, 공식 메터링 API보다 생성 비용이 수 배 낮습니다.

공식 Gemini API와 Vertex에서 Veo 초당 출력에 대한 메터링을 적용합니다. 외부 Google Flow API(https://useapi.net/docs/api-google-flow-v1)는 평탄한 구독(https://useapi.net/docs/subscription)을 기반으로 동작하며, 일반 Flow 크레딧에 월 1회 비용만 추가해 API 액세스를 제공하므로 클립당 비용이 크게 저렴합니다. 아래에서는 사용 가능한 모델 목록, 공식 API 대비 가격 차이, 두 번의 호출 워크플로와 실행 가능한 배치 스크립트를 안내합니다.

Supported models

요청당 모델을 선택하며 model 필드(기본값 veo-3.1-fast)를 사용합니다. 크레딧 비용은 Google의 공식 Flow 크레딧 표(https://support.google.com/flow/answer/16526234)에서 확인할 수 있습니다:

참고: 개요에서 4s/6s는 Veo에서 Ultra 전용이며, veo-3.1-quality은 8s 전용이고, veo-3.1-lite-low-priority는 0 크레딧 비용이지만 Google AI Ultra $199 구독자만 이용 가능하며, 10s 클립은 omni-flash 전용입니다. Google Flow도 별도의 POST /images 엔드포인트를 통해 Imagen 4와 Nano Banana 모델로 스틸 이미지를 생성할 수 있습니다.

Pricing

Google AI 플랜의 Flow 크레딧을 평소와 같이 사용하고, 월 $15를 지불하여 useapi.net에서 모든 지원 서비스를 API로 이용합니다 — 호출당 추가 요금이 없습니다.

제3자 Google Flow API(https://useapi.net/docs/api-google-flow-v1)는 useapi.net에서 제공하며, 공식 **Gemini API**와 대비합니다 — 메터링 대신 자체 Google Flow 구독으로 호출당 과금됩니다:

예상 일일 출력 — $199/월 Ultra 플랜. 실제 계정에서 관측된 일일 평균. 여기서는 예상치이며 보장되지 않음: Google이 해당 Flow 허용량을 관리하며 수요에 따라 변동됩니다.

Free workload (no Flow credits spent)

Avg generations / day*

• Veo 3.1 Lite — lower priority video ~1,000
• Images — Nano Banana, Nano Banana Pro, Imagen 4 up to ~500

가장 활동적인 실제 계정의 평균 — 보장되지 않음. Google 자체 허용량에 따라 설정되며 수요에 따라 변동됩니다. 무료 낮은 우선순위 비디오 큐와 이미지 생성에만 적용됩니다.

Credit-metered models (Veo 3.1 Fast / Quality and Gemini Omni Flash) are not shown here — their volume is bounded by your plan’s monthly Flow credits (see the credit table), not a free allowance.

동영상 생성에 두 번의 API 호출

사용하려면 useapi.net API 토큰(https://useapi.net/docs/start-…)이 필요하고, 연결된 Google Flow 계정(https://useapi.net/docs/start-… )을 보유해야 합니다. 생성은 비동기적으로 진행됩니다: async: true를 전달하면 create 호출이 즉시 jobid를 반환한 뒤, 결과가 준비될 때까지 폴링합니다.

Submit the job — POST https://api.useapi.net/v1/google-flow/videos

curl -X POST "https://api.useapi.net/v1/google-flow/videos" \
   -H "Authorization: Bearer $USEAPI_TOKEN" \
   -H "Content-Type: application/json" \
   -d '{ 
     "prompt": "A serene mountain landscape at sunset, camera slowly panning right",
     "model": "veo-3.1-fast",
     "aspectRatio": "landscape",
     "duration": 8,
     "async": true
   }'

status는 created → started → completed 로 이동합니다. completed 상태가 되면 response.media[].videoUrl(단일 프롬프트에 count > 1이면 각 클립당 하나의 항목)이 제공됩니다:

{
   "jobid": "j1731859234567v-...",
   "type": "video",
   "status": "completed",
   "response": {
     "media": [
       {
         "mediaGenerationId": "user:12345-email:6a6f...-video:a1d95d21-...",
         "videoUrl": "https://flow-content.google/video/a1d95d21-...?Expires=...",
         "thumbnailUrl": "https://flow-content.google/image/a1d95d21-...?Expires=..."
       }
     ],
     "remainingCredits": 18760
   }
}

Veo 3.1은 모델과 모드에 따라 60~180초 정도 소요됩니다. 서명된 videoUrl은 약 24시간 유효하니 결과를 다운로드할 때는 신속히 처리하세요. 폴링을 피하고 싶다면 replyUrl을 create_body에 추가해 웹훅 콜백을 받을 수 있습니다.

Image-to-video and reference-to-video

Veo는 이미지 입력을 두 가지 방식으로 수용합니다. 각 이미지를 먼저 POST /assets/email(원본 바이트, 이미지 Content-Type, PNG/JPEG/WebP, 최대 20 MB)로 업로드합니다. 응답에 mediaGenerationId가 중첩되어 있으며, 이 문자열을 다시 요청_body에 전달하면 됩니다. 이미지 입력을 제공하면 email 필드를 생략해도 계정과 연결된 이미지로 라우팅됩니다.

First / last frame (I2V)

이미지가 실제 프레임으로 사용됩니다. startImage을 요청_body에 포함시켜 주세요.