Veo 3.1
공급사 정가. 플랫폼 마진 없음, 종량제. 아래는 공식 정가입니다. 로그인한 고객은 /console/pricing 에서 워크스페이스 할인이 반영된 실제 가격을 볼 수 있습니다.
30초 만에 Veo 3.1 사용하기
비동기 작업 API: 작업을 생성한 뒤 폴링하거나 Prefer: wait로 요청을 유지해 완료를 기다립니다. POST /v1/videos
import time
import requests
BASE = "https://synthorai.io/v1"
HEADERS = {"Authorization": "Bearer sk-syn-..."}
# 1) create the video generation job (POST /v1/videos)
task = requests.post(
f"{BASE}/videos",
headers=HEADERS,
json={
"model": "veo-3.1-generate-001",
"prompt": "a watercolor lighthouse at dawn, waves rolling in, camera pulling back",
"resolution": "720p",
"duration": 5,
},
).json()
# 2) poll the job until it reaches a terminal state
while task["status"] in ("queued", "in_progress"):
time.sleep(5)
task = requests.get(f"{BASE}/videos/{task['id']}", headers=HEADERS).json()
# 3) completed → signed video URL (valid ~24h — download and store it promptly)
if task["status"] == "completed":
print(task["data"][0]["url"])
else:
print(task["error"])const HEADERS = {
Authorization: "Bearer sk-syn-...",
"Content-Type": "application/json",
};
interface VideoTask {
id: string;
status: "queued" | "in_progress" | "completed" | "failed" | "cancelled";
data?: Array<{ url: string }>;
error?: { code: string; message: string };
}
// 1) create the video generation job (POST /v1/videos)
const created = await fetch("https://synthorai.io/v1/videos", {
method: "POST",
headers: HEADERS,
body: JSON.stringify({
model: "veo-3.1-generate-001",
prompt: "a watercolor lighthouse at dawn, waves rolling in, camera pulling back",
resolution: "720p",
duration: 5,
}),
});
let task = (await created.json()) as VideoTask;
// 2) poll the job until it reaches a terminal state
while (task.status === "queued" || task.status === "in_progress") {
await new Promise((r) => setTimeout(r, 5000));
const res = await fetch(`https://synthorai.io/v1/videos/${task.id}`, { headers: HEADERS });
task = (await res.json()) as VideoTask;
}
// 3) completed → signed video URL (valid ~24h — download and store it promptly)
if (task.status === "completed") console.log(task.data?.[0]?.url);
else console.error(task.error);# Create the job; "Prefer: wait" holds the request up to 60s and returns the
# completed task when generation finishes in time (else the queued task).
curl https://synthorai.io/v1/videos \
-H "Authorization: Bearer sk-syn-..." \
-H "Content-Type: application/json" \
-H "Prefer: wait=60" \
-d '{
"model": "veo-3.1-generate-001",
"prompt": "a watercolor lighthouse at dawn, waves rolling in, camera pulling back",
"resolution": "720p",
"duration": 5
}'
# Still queued / in_progress? Poll until completed → data[0].url (valid ~24h).
curl https://synthorai.io/v1/videos/vid_9f2e8c1a4b7d \
-H "Authorization: Bearer sk-syn-..."package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
"time"
)
const base = "https://synthorai.io/v1"
type videoTask struct {
ID string `json:"id"`
Status string `json:"status"`
Data []struct {
URL string `json:"url"`
} `json:"data"`
}
func call(method, url string, body []byte) (t videoTask) {
req, _ := http.NewRequest(method, url, bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer sk-syn-...")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
json.NewDecoder(resp.Body).Decode(&t)
return t
}
func main() {
// 1) create the video generation job (POST /v1/videos)
payload, _ := json.Marshal(map[string]any{
"model": "veo-3.1-generate-001",
"prompt": "a watercolor lighthouse at dawn, waves rolling in, camera pulling back",
"resolution": "720p",
"duration": 5,
})
task := call("POST", base+"/videos", payload)
// 2) poll the job until it reaches a terminal state
for task.Status == "queued" || task.Status == "in_progress" {
time.Sleep(5 * time.Second)
task = call("GET", base+"/videos/"+task.ID, nil)
}
// 3) completed → signed video URL (valid ~24h — download and store promptly)
if task.Status == "completed" {
fmt.Println(task.Data[0].URL)
}
}import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
// JDK built-in HttpClient — no extra dependency needed.
HttpClient http = HttpClient.newHttpClient();
// 1) create the job; "Prefer: wait=60" holds the request up to 60s and
// returns the completed task when generation finishes in time
HttpRequest create = HttpRequest.newBuilder(URI.create("https://synthorai.io/v1/videos"))
.header("Authorization", "Bearer sk-syn-...")
.header("Content-Type", "application/json")
.header("Prefer", "wait=60")
.POST(HttpRequest.BodyPublishers.ofString("""
{"model": "veo-3.1-generate-001",
"prompt": "a watercolor lighthouse at dawn, waves rolling in, camera pulling back",
"resolution": "720p", "duration": 5}"""))
.build();
String task = http.send(create, HttpResponse.BodyHandlers.ofString()).body();
System.out.println(task); // {"id":"vid_…","status":…} — completed → data[0].url
// 2) still queued / in_progress? Poll GET https://synthorai.io/v1/videos/{id} until the
// status turns completed, then download data[0].url (valid ~24h).Veo 3.1 소개
Veo 3.1은 Google의 현행 플래그십 영상 생성 모델로, Veo 라인의 최신 버전입니다.
- 텍스트 프롬프트에서, 첫 프레임 이미지에서, 또는 두 장의 가이드 이미지 사이의 첫/마지막 프레임 보간으로 .mp4 클립을 생성하며, 모두 네이티브 동기화 오디오 — 립싱크 대사, 환경음, 음악 — 를 포함합니다.
- 출력은 720p 또는 1080p, 24 fps, 4·6·8초, 16:9 또는 9:16이며, generateAudio 스위치로 사운드 온과 무음 출력을 선택합니다.
- Veo 3.1은 Veo 3보다 오디오-비주얼 동기화와 참조 이미지 충실도를 높였습니다.
- Synthorai는 비동기 /v1/videos 작업 API로 제공하며 — 작업을 생성한 뒤 서명된 동영상 URL이 준비될 때까지 폴링합니다(또는 Prefer: wait로 호출을 유지합니다) — 사운드와 무음에 대해 별도 단가로 출력 초 단위로 과금합니다.
스펙 및 제한
| 모달리티 | text + image → video |
| 기능 | vision |
| 해상도 | 720p / 1080p |
| 길이 | 4 / 6 / 8 s |
| 프레임 레이트 | 24 fps |
| 화면 비율 | 16:9 · 9:16 |
| 비디오 입력 | text-to-video · first-frame & first/last-frame image-to-video (up to 2 guide images) |
| 네이티브 오디오 | 예 — 사운드 생성 |
| 포맷 | .mp4 |
| 특기 사항 | Google's Veo 3.1 video model, the current flagship of the Veo line: text-to-video, first-frame image-to-video, and first-and-last-frame interpolation (up to two guide images), all with native synchronized audio (dialogue, ambient sound, music); 720p/1080p, 24 fps, 4/6/8 s, 16:9 and 9:16; a generateAudio switch selects sound-on vs silent output. Veo 3.1 sharpens audio-visual sync and reference-image adherence over Veo 3. Synthorai serves it via the async /v1/videos job API — create a task, then poll it (or hold the request open with Prefer: wait) until the signed video URL is ready — and bills per output second at separate sound-on and silent rates. |
출처: Google 공식 문서 ↗
자주 묻는 질문
Veo 3.1 API는 무료로 사용해 볼 수 있나요?
네, 신규 계정에는 10회의 체험 호출과 최대 $1의 무료 크레딧이 제공되며, 카드 등록이 필요 없습니다. 결제 수단을 추가하기 전에 실제 워크로드로 Veo 3.1을(를) 충분히 시험해 볼 수 있는 양입니다.
Veo 3.1은(는) 무엇에 가장 강한가요?
네이티브 오디오를 갖춘 현행 Veo 플래그십, 그리고 첫/마지막 프레임 이미지-투-비디오, 가이드 최대 두 장 및 사운드·무음 출력을 별도 단가로. 전체 내용은 벤더의 공식 릴리스 노트를 정리한 About 섹션을 참고하세요.
Veo 3.1의 가격은 얼마인가요?
Synthorai에서 Veo 3.1은(는) 생성된 영상 1초당 $0.4로 과금됩니다. 생성에 성공한 경우에만 과금됩니다. 종량제, 플랫폼 마진 없음, 구독 불필요.
Veo 3.1 API로 영상을 어떻게 생성하나요?
Synthorai의 /v1/videos에 model="veo-3.1-generate-001"로 POST를 보내 비동기 작업을 생성한 뒤, 작업을 폴링하거나 Prefer: wait 헤더로 요청을 유지한 채 완료를 기다리면 영상 URL을 받을 수 있습니다. 벤더 SDK는 필요 없습니다.
Veo 3.1은(는) 어떻게 이용하나요?
기존 OpenAI SDK의 base_url을 "https://synthorai.io/v1"로 지정하고 model="veo-3.1-generate-001"로 설정하면 끝입니다. API 키 하나로 게이트웨이의 모든 모델을 사용할 수 있습니다.