입력실제 스키마

提示词*prompt

分辨率*resolution

No test requests yet. Send your first request.

출력

왼쪽 양식을 실행하세요. 결과, 폴링 상태, cURL이 양식 아래에 표시됩니다.

가격

이 모델은 아래 사용량 항목 기준으로 과금됩니다. 전체 가격 비교.

정가는 USD 기준입니다. 실제 가격은 API 키에 연결된 과금 그룹에 따라 달라집니다.

과금 기준4 - 720pveo-3.1-fast

$0.32요청당~~0.4/次~~

과금 기준6 - 720pveo-3.1-fast

$0.48요청당~~0.6/次~~

과금 기준8 - 720pveo-3.1-fast

$0.64요청당~~0.8/次~~

과금 기준4 - 1080pveo-3.1-fast

$0.384요청당~~0.48/次~~

과금 기준6 - 1080pveo-3.1-fast

$0.576요청당~~0.72/次~~

과금 기준8 - 1080pveo-3.1-fast

$0.768요청당~~0.96/次~~

API

POST/v1/jobs

const BASE_URL = "https://api.dreamtoai.com";
const API_KEY = process.env.MIX_API_KEY;

const headers = {
  "Authorization": `Bearer ${API_KEY}`,
  "Content-Type": "application/json",
};

const payload = {
  "model": "veo-3.1-fast",
  "input": {
    "prompt": "一段自然纪录片风格的雪山航拍镜头",
    "image": "https://example.com/image.png",
    "lastframe": [
      "https://example.com/ref.png"
    ],
    "referenceImages": [
      "https://example.com/ref.png"
    ],
    "video": [
      "https://example.com/ref.mp4"
    ],
    "aspectratio": "16:9,9:16",
    "resolution": "720p,1080p,4k",
    "generate_audio": false,
    "negative_prompt": "低清晰度、闪烁、变形",
    "durationseconds": "4,6,8"
  }
};

const submit = await fetch(`${BASE_URL}/v1/jobs`, {
  method: "POST",
  headers,
  body: JSON.stringify(payload),
}).then((r) => r.json());

const status = await fetch(`${BASE_URL}/v1/jobs/${submit.id}`, { headers })
  .then((r) => r.json());
console.log(status);

콘솔 → API 키에서 키를 만들고 샘플의 자리표시자를 교체하세요.

README

veo-3.1-fast

Veo 3.1 是一种用于生成 8 秒视频（720p、1080p 或 4k）的模型，可原生生成音频。

왜 선택해야 할까요?

텍스트→영상 생성: 자연어 프롬프트를 영상 클립으로 바꿉니다.
예측 가능한 가격: 요청당 $0.32부터, 실행한 만큼만 과금됩니다.
다양한 출력 옵션: 4 - 720p, 6 - 720p, 8 - 720p, 4 - 1080p, 6 - 1080p, 8 - 1080p 중에서 선택하세요.
비동기 작업 API: 작업을 제출하고 결과를 폴링하므로 긴 렌더링에도 연결을 붙잡고 있지 않습니다.
키 하나로 모든 모델: 같은 API 키로 dreamtoai의 모든 모델을 사용할 수 있습니다.

파라미터

파라미터	필수	설명
`prompt`string	필수	생성할 내용에 대한 텍스트 설명.
`aspectratio`string	필수	画幅比例 기본값: `16:9`.
`resolution`string	필수	출력 해상도. 기본값: `720p`.
`durationseconds`string	필수	时长 기본값: `4`.
`image`image	선택	결과를 유도할 참조 이미지.
`lastframe`image	선택	参考图 URL
`referenceImages`string	선택	参考图 URL
`video`video	선택	参考视频 URL
`generate_audio`boolean	선택	영상과 동기화된 오디오를 생성합니다.
`negative_prompt`string	선택	결과에서 제외할 내용.

사용 방법

여기서 먼저 써 보기 — 로그인한 뒤 위 Playground에서 모델을 실행해 코드를 쓰기 전에 출력을 확인하세요.
API 키 만들기 — 콘솔 → API 키에서 키를 만드세요. 같은 키로 모든 모델을 쓸 수 있습니다.
프롬프트 작성 — 장면, 동작, 카메라 움직임, 조명, 분위기를 설명합니다.
선택 파라미터 설정 — 위에 나열된 선택 파라미터를 조정해 출력을 제어하세요.
작업 제출 — 모델 ID veo-3.1-fast로 POST /v1/jobs를 보내세요. 응답에 작업 ID가 반환됩니다.
결과 폴링 — 작업이 끝날 때까지 몇 초마다 GET /v1/jobs/{job_id}를 호출한 뒤 출력 URL을 읽으세요.

효과적인 프롬프트 작성법

프롬프트를 샷 리스트처럼 쓰세요. 구체적으로 연출할수록 모델이 더 잘 해냅니다.

1. 한 줄 요약

피사체, 장소, 동작, 스타일, 카메라를 한 문장으로 시작하세요.

새벽 안개 낀 숲길을 달리는 자전거 라이더, 시네마틱, 측면에서 천천히 따라가는 트래킹 샷.

2. 긴 클립은 타임라인으로

클립을 0–3초, 3–6초처럼 시간 구간으로 나누고 구간마다 명확한 동작 하나만 넣으세요.

3. 카메라 언어

샷 크기(와이드, 미디엄, 클로즈업)와 움직임(푸시인, 팬, 오빗, 핸드헬드)을 그대로 쓰세요.

4. 일관성 메모

마지막에 클립 전체에 유지할 요소(조명, 색감, 분위기, 사운드)를 적으세요.

	프롬프트
약한 예	달리는 개
강한 예	해 질 녘 젖은 해변을 빨간 공을 쫓아 전력 질주하는 골든 리트리버. 0–2초: 개 옆에서 낮게 따라가는 트래킹 샷, 모래가 튄다. 2–5초: 공을 물고 카메라 쪽으로 돌아서며 천천히 푸시인. 따뜻한 역광, 옅은 바다 물보라, 얕은 심도, 파도 소리만.

가격

과금 항목	가격	공식 가격
4 - 720p	$0.32 요청당	~~$0.40/次~~
6 - 720p	$0.48 요청당	~~$0.60/次~~
8 - 720p	$0.64 요청당	~~$0.80/次~~
4 - 1080p	$0.384 요청당	~~$0.48/次~~
6 - 1080p	$0.576 요청당	~~$0.72/次~~
8 - 1080p	$0.768 요청당	~~$0.96/次~~

공식 정가보다 20% 저렴합니다.

예: 4 - 720p(으)로 10회 실행하면 $3.20입니다.

정가는 USD 기준입니다. 실제 가격은 API 키에 연결된 과금 그룹에 따라 달라집니다. 전체 가격 비교

전문가 팁

가장 짧은 길이와 가장 낮은 해상도로 테스트한 뒤 올리세요.
점프 컷을 피하려면 시간 구간마다 명확한 동작 하나만 주세요.
와이드스크린은 16:9, 세로형 소셜 영상은 9:16을 쓰세요.
카메라 움직임을 명시하세요. 쓰지 않으면 모델이 임의로 고릅니다.
작업 상태는 간격을 점점 늘려 가며 폴링하고 엔드포인트를 과도하게 호출하지 마세요.

veo-3.1
Gemini-3.1-flash-lite-image — gemini-3-1-flash-lite-image
gemini-3.1-flash-image — gemini-3-1-flash-image
gemini-3-pro-image
Nano Banana 2 — nano-banana-2
Nano Banana Pro — nano-banana-pro

모든 영상 모델 보기 API 마켓 둘러보기

FAQ

veo-3.1-fast란 무엇인가요?

Veo 3.1 是一种用于生成 8 秒视频（720p、1080p 或 4k）的模型，可原生生成音频。

veo-3.1-fast API는 어떻게 호출하나요?

API 키와 모델 ID veo-3.1-fast로 POST /v1/jobs를 보내세요. 바로 실행할 수 있는 샘플은 위 API 섹션에 있습니다.

요금은 어떻게 계산되나요?

요청은 위에 표시된 가격으로 지갑에서 청구됩니다. 최종 비용은 사용량과 API 키에 연결된 과금 그룹에 따라 달라집니다.

API 키는 어디서 받나요?

콘솔 → API 키에서 생성하세요. 동일한 키로 게이트웨이의 모든 모델을 사용할 수 있습니다.

출력물을 상업적으로 사용할 수 있나요?

네. 생성한 결과물은 모델 제공사의 약관을 따르는 한 상업 프로젝트에 사용할 수 있습니다.

Google/veo-3.1-fast