KO ▾
API 키 받기

홈문서

시작하기: 비디오 워크플로우에 무검열 텍스트 통합하기

단일 기본 URL 변경만으로 비디오 생성 파이프라인에 무검열 텍스트 API를 통합하세요. 표준 OpenAI 호환 클라이언트를 사용하여 콘텐츠 필터가 창작물에 방해 없이 스크립트, 프롬프트 및 메타데이터를 생성할 수 있습니다.

인증 및 기본 URL

대시보드에서 API 키를 발급받는 것으로 시작하세요. 당사 서비스는 표준 OpenAI 호환 인증을 사용합니다. 기본 URL을 https://api.aivideogenapi.com/v1로 설정하고 Authorization 헤더에 키를 전달하세요. 이렇게 하면 기존 OpenAI 표준을 지원하는 비디오 워크플로우 도구를 통합 로직을 수정하지 않고도 사용할 수 있습니다.

  • 기본 URL: https://api.aivideogenapi.com/v1
  • 인증 헤더: Authorization: Bearer YOUR_API_KEY
  • 모델 ID: uncensored

키가 활성화되어 있는지 확인하세요. 키는 생성 시 즉시 재발급되며 계정 설정에서 언제든지 취소할 수 있습니다.

채팅 완성 보내기

스크립트나 프롬프트를 생성하기 위해 간단한 텍스트 요청을 보내세요. API는 표준 messages 배열을 받습니다. 모델이 무검열이므로 미성년자가 관여하는 경우를 제외하고 합법적인 성인 대상의 허구적이거나 논쟁적인 주제를 거부하지 않습니다. 안전 필터가 창의적인 텍스트를 잘라내지 않도록 비디오 설명, 장면 지시 또는 메타데이터를 생성하는 데 사용하세요.

curl https://api.aivideogenapi.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."}]
  }'

응답에는 생성된 텍스트를 포함하는 content 필드가 있습니다. 이 텍스트는 비디오 생성 엔진에 직접 전달하거나 비디오 메타데이터 필드를 채우는 데 사용할 수 있습니다.

Python SDK 통합

사용자 정의 기본 URL과 함께 공식 openai Python SDK를 사용하세요. 이는 Python으로 작성된 비디오 파이프라인에 텍스트 API를 통합하는 가장 일반적인 방법입니다. API 키와 올바른 기본 URL로 클라이언트를 초기화한 후 chat.completions.create를 호출합니다.

from openai import OpenAI

client = OpenAI(base_url="https://api.aivideogenapi.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)

이 접근 방식은 기존 Python 비디오 처리 라이브러리를 활용하면서 텍스트 생성을 당사 무검열 모델에 위임할 수 있습니다. 생성된 비디오 스크립트의 어조와 스타일을 안내하기 위해 시스템 프롬프트를 전달할 수 있습니다.

Node.js SDK 통합

JavaScript 또는 TypeScript 워크플로우의 경우 openai Node.js 패키지를 사용하세요. Python SDK와 마찬가지로 API 키와 기본 URL로 클라이언트를 구성하세요. 이는 Node 기반 비디오 자동화 스크립트에 원활한 통합을 가능하게 합니다.

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.aivideogenapi.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);

이 텍스트 생성의 출력을 비디오 생성 API 호출에 직접 연결할 수 있습니다. 무검열 모델은 표준 필터가 수정할 수 있는 성숙한 주제나 틈새 창작 방향이 포함된 경우에도 프롬프트가 그대로 유지되도록 보장합니다.

스트리밍 응답

실시간 업데이트 또는 큰 스크립트 생성을 위해 stream: true를 설정하여 스트리밍을 활성화하세요. API는 서버 전송 이벤트(SSE)를 반환합니다. 이는 텍스트 생성 진행 상황을 표시하는 UI를 구축하거나 전체 응답을 기다리지 않고 긴 비디오 스크립트를 청크로 처리하는 데 유용합니다.

stream = 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)

클라이언트 코드에서 스트림 이벤트를 처리하여 최종 텍스트를 누적하세요. 스트리밍은 토큰 카운팅이나 가격 책정에 영향을 주지 않습니다. 요청 및 응답에서 사용된 총 토큰에 대해 요금이 청구됩니다.

속도 제한, 오류 및 컨텍스트

각 API 키는 분당 300개의 요청으로 제한됩니다. 이를 초과하면 429 속도 제한 오류가 발생합니다. 최대 요청 본문 크기는 8 MB입니다. API 키가 유효하지 않으면 401 오류가 발생합니다. 크레딧 고갈은 특정 오류 코드를 반환하지 않으며, 선불 잔액을 충전할 때까지 새 요청을 차단합니다.

컨텍스트 창은 프롬프트와 완성을 합쳐 100,000 토큰입니다. 이는 단일 요청으로 긴 비디오 스크립트를 생성하거나 큰 메타데이터 세트를 처리하기에 충분합니다. 더 많은 컨텍스트가 필요한 경우 입력을 더 작은 배치로 분할하세요.

기술 사양

크레딧을 구매하기 전에 확인할 수 있도록 API의 실제 한도와 기능을 한곳에 정리했습니다.

항목내용
형식OpenAI 호환: 어떤 OpenAI SDK든 base URL과 키만 바꾸면 동작
인증Authorization: Bearer YOUR_KEY
모델 IDuncensored
엔드포인트POST /v1/chat/completions · GET /v1/models
Base URLhttps://api.aivideogenapi.com/v1
컨텍스트 창100,000 토큰 (입력 + 출력)
스트리밍지원 — SSE, 마지막 청크에 토큰 사용량 포함
함수 호출지원 — tools, tool_choice; 응답에 tool_calls (스트리밍 포함), 결과는 role: tool로 전송
파라미터temperature, top_p, stop, seed, presence_penalty, frequency_penalty
최대 출력100,000 토큰 윈도우의 남은 만큼; max_tokens는 선택 사항(별도 상한 없음)
JSON 모드response_format: {"type": "json_object"}
속도 제한키당 분당 300회
응답 헤더X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
요청 크기최대 8 MB
동시 요청키당 동시 8개
유효기간유료 크레딧은 만료되지 않으며 구독 없음
무료 체험$0.50, 7일, 카드 불필요 · 체험 키: 동시 요청 2건, 분당 60건. 첫 충전 후 전체 한도(8건, 300건) 적용
충전USDT (TRC20) 또는 USDC (Base), $10~$500 사이 원하는 정수 금액
가격입력 100만 토큰당 $0.25 · 출력 100만 토큰당 $1.00
과금선불 크레딧에서 실제 사용량만큼 차감, 오류·거부는 무료
보너스$50 이상 +5%, $100 이상 +10%
로그인Google 또는 이메일과 비밀번호
키계정당 활성 키 1개, 새 키를 만들면 이전 키는 무효
콘텐츠성인 콘텐츠 허용, 미성년자가 관련된 성적 콘텐츠는 거부

오류 코드

오류는 고정된 type을 가진 JSON으로 반환되며, 실패하거나 거부된 요청은 과금되지 않습니다.

코드유형의미
400bad_request잘못된 JSON, 빈 메시지, 잘못된 파라미터 또는 컨텍스트 초과
401missing_key · invalid_key · key_revoked키 없음·잘못됨·새 키로 교체됨
402no_credit잔액 없음 — 충전하면 즉시 재개
403content_blocked미성년자 관련 성적 콘텐츠 — 거부, 과금 없음
404not_found알 수 없는 엔드포인트
413request_too_large본문 8 MB 초과
429rate_limited · concurrency분당 300회 또는 동시 8개 초과 — 잠시 후 재시도
503upstream_busy모델 혼잡 — 몇 초 후 재시도

질문과 답변

비디오 스크립트에 '무검열'이란 무엇인가요?

법적인 성인, 픽션, 논쟁적인 주제를 거부하지 않는다는 의미입니다. 안전 필터가 창작 프롬프트를 수정하지 않도록 법적 성인 사용에 콘텐츠 거절 없이 답변하도록 조정되었습니다. 미성년자가 관련된 성적인 콘텐츠는 항상 차단됩니다.

시작하려면 신용카드가 필요한가요?

아니요. 모든 신규 계정에는 7일 동안 유효한 $0.50의 무료 체험 크레딧이 제공됩니다. 이메일과 비밀번호만으로 가입할 수 있습니다. 선불 잔액을 충전할 때만 암호화폐(USDT 또는 USDC)가 필요합니다.

기존 OpenAI SDK와 함께 사용할 수 있나요?

네. API는 OpenAI와 완전히 호환됩니다. 기본 URL을 <code>https://api.aivideogenapi.com/v1</code>로 변경하고 API 키를 제공하기만 하면 Python 및 Node.js용 공식 OpenAI SDK를 사용할 수 있습니다.

키는 양식 하나만 작성하면 받을 수 있습니다

계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것뿐입니다.

API 키 받기