Veo 3 API: 하나의 엔드포인트로 프롬프트와 스크립트 전송

전제 조건 및 인증

첫 번째 요청을 하기 전에 유효한 API 키가 있는지 확인하세요. 이메일과 비밀번호만으로 API 키 받기 페이지에서 가입하세요. 즉시 7일 동안 유효한 $0.50의 무료 체험 크레딧을 받으며, 신용카드가 필요하지 않습니다. 프로덕션 워크로드의 경우, 계속된 접근을 위해 최소 $10를 충전하세요.

기본 URL은 https://api.veo3apis.com/v1.입니다. Authorization 헤더에 Bearer 토큰으로 API 키를 포함하세요. 이 엔드포인트는 완전히 OpenAI 호환이므로, 기본 URL을 가리키도록 표준 SDK를 사용할 수 있습니다.

기본 채팅 완료

텍스트를 생성하려면 /v1/chat/completions으로 표준 POST 요청을 보내세요. 모델 ID는 "uncensored"입니다. 이는 실시간 업데이트가 필요 없는 간단한 프롬프트 생성 또는 스크립트 작성 작업에 이상적인 단일 JSON 객체로 전체 응답을 반환합니다.

Python SDK 통합

깔끔한 통합을 위해 공식 OpenAI Python SDK를 사용하세요. 클라이언트를 기본 URL과 API 키로 구성하세요. 이 방법은 다중 모드 파이프라인의 오류 처리 및 토큰 카운팅을 단순화합니다.

Node SDK 통합

JavaScript/TypeScript 프로젝트의 경우 OpenAI Node SDK가 바로 작동합니다. 클라이언트를 기본 URL로 연결하세요. 이는 서버 측 스크립트 생성 또는 Veo 3 워크플로의 후처리 단계에 유용합니다.

스트리밍 응답 (SSE)

인지된 지연 시간을 줄이려면 stream: true를 설정하여 스트리밍을 활성화하세요. API는 부분 응답의 서버 전송 이벤트(SSE) 스트림을 반환합니다. 이를 통해 애플리케이션은 생성되는 대로 토큰을 표시할 수 있으며, 긴 스크립트 생성 또는 복잡한 추론 작업에 중요합니다.

제한, 오류 및 컨텍스트 창

각 키당 분당 300회 요청까지 속도 제한이 적용됩니다. 이를 초과하면 429 오류가 발생합니다. 인증 실패는 401을, 잔액 부족은 402을 반환합니다. 컨텍스트 창은 프롬프트와 완성 텍스트를 합쳐 총 100,000 토큰입니다. 페이로드 크기는 8 MB 미만이어야 합니다. 미성년자 관련 성적 콘텐츠는 항상 차단되는 유일한 하드 콘텐츠 제한입니다.

cURL

Copycurl https://api.veo3apis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.veo3apis.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.veo3apis.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

스트리밍

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)