KO ▾
API 키 받기

Sora 2 파이프라인 시작하기

OpenAI 호환 API를 사용하여 Sora 2 비디오 파이프라인에 무검열 텍스트를 생성하세요. 이 시작 가이드에는 인증, 기본 요청, 스트리밍, 함수 호출이 포함되어 텍스트 엔진을 즉시 실행할 수 있습니다.

인증 및 Base URL

당사의 API는 표준 OpenAI 호환 인증을 사용합니다. 대시보드에서 API 키와 Base URL https://api.sora2apis.com/v1이 필요합니다. Authorization 헤더에 Bearer 토큰으로 키를 전달하세요. 이 설정은 OpenAI 호환을 지원하는 모든 SDK에서 작동합니다.

계정을 등록하여 키를 받으세요. 새 계정에는 7일 동안 사용 가능한 $0.50의 무료 체험 크레딧이 제공되며 신용카드가 필요하지 않습니다. 유료 사용의 경우 충전은 $10부터 시작됩니다. 키는 등록 직후 생성되며 언제든지 재생성할 수 있습니다.

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

채팅 완료 엔드포인트

핵심 엔드포인트는 POST /v1/chat/completions입니다. 이 엔드포인트는 model 필드에 uncensored을 설정하여 사용합니다. 이는 합법적인 성인용 목적으로 콘텐츠 거부 없이 답변하도록 조정된 오픈 웨이트 모델입니다. 이 모델은 프롬프트와 completion 모두에 대해 100,000 토큰의 컨텍스트 창을 지원합니다.

messages 배열을 통해 텍스트 입력을 보내세요. API는 비디오 생성 파이프라인에 사용할 준비가 된 텍스트 출력을 반환합니다. 이 엔드포인트에는 임베딩, 오디오 또는 비디오 생성 기능이 없습니다. 엄격히 텍스트 입력, 텍스트 출력입니다.

from openai import OpenAI

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

스트리밍 응답 (SSE)

실시간 텍스트 생성을 위해 요청에 stream: true을 설정하세요. API는 생성되는 대로 토큰을 처리할 수 있는 Server-Sent Events (SSE)를 반환합니다. 이는 진행 상황을 표시하거나 데이터를 점진적으로 공급하려는 긴 대본이나 캡션에 유용합니다.

각 SSE 이벤트는 응답의 부분 델타를 포함합니다. 이러한 델타를 집계하여 전체 텍스트를 복원하세요. 스트리밍 응답은 표준 OpenAI SSE 형식을 따르며 대부분의 현대적인 SDK와의 호환성을 보장합니다. 이는 Sora 2 워크플로우의 동적 콘텐츠 생성에 이상적입니다.

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는 도구 및 함수 호출을 지원하여 모델이 사용할 사용자 정의 함수를 정의할 수 있습니다. 이는 텍스트 파이프라인 내에서 구조화된 데이터 추출 또는 자동화된 의사 결정에 유용합니다. tools 배열에 도구를 정의하고 모델이 응답하는 방식을 지정하세요.

모델은 적절한 경우 도구 호출을 반환하며, 이를 실행하여 대화에 다시 피드백할 수 있습니다. 이는 텍스트 엔진이 외부 시스템과 상호 작용하거나 비디오 생성 요구 사항에 맞게 데이터를 정확하게 형식화할 수 있는 복잡한 워크플로우를 가능하게 합니다. 이는 고급 Sora 2 파이프라인을 위한 강력한 기능입니다.

속도 제한 및 사용량

키당 분당 300개의 요청으로 제한됩니다. 최대 요청 본문 크기는 8 MB입니다. 속도 제한을 초과하면 429 오류가 발생합니다. 애플리케이션이 재시도를 적절히 처리하도록 하세요. 각 계정에는 하나의 API 키가 제공되며, 이는 언제든지 재생성할 수 있으며 이전 키는 무효화됩니다.

가격은 입력 토큰 100만 개당 $0.25, 출력 토큰 100만 개당 $1.00입니다. 크레딧은 선불이며 만료되지 않습니다. 크레딧이 부족하면 402 오류가 발생합니다. 유효하지 않은 키는 401 오류를 반환합니다. 충전은 $10부터 시작하며, 더 많은 금액을 충전할 경우 보너스가 제공됩니다.

모델 구성

모델 ID는 항상 uncensored입니다. 이 모델은 자체 GPU 서버에서 실행되는 오픈 웨이트 모델로, 거부 없이 합법적인 성인 콘텐츠에 맞춰 조정되었습니다. GPT, Claude, Gemini, Grok 또는 DeepSeek가 아닙니다. 이 모델은 오디오, 이미지 또는 비디오를 생성하지 않습니다. 텍스트 생성 전용입니다.

출력을 제어하기 위해 temperature 및 max_tokens과 같은 표준 매개변수를 조정할 수 있습니다. 컨텍스트 창은 100,000 토큰입니다. 이 유연성은 특정 Sora 2 비디오 생성 요구 사항에 맞게 텍스트 출력을 미세 조정할 수 있게 합니다. 이 모델은 파이프라인을 위한 신뢰할 수 있는 텍스트 엔진으로 설계되었습니다.

Node.js

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.sora2apis.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의 실제 한도와 기능을 한곳에 정리했습니다.

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

오류 코드

오류는 고정된 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모델 혼잡 — 몇 초 후 재시도

질문과 답변

컨텍스트 창 크기는 얼마인가요?

컨텍스트 창은 100,000 토큰이며, 여기에는 프롬프트와 생성 결과가 모두 포함됩니다. 이를 통해 스크립트와 상세 설명에 적합한 장문 콘텐츠 생성이 가능합니다.

속도 제한은 어떻게 처리하나요?

키당 분당 요청 수는 300개로 제한됩니다. 이 한도를 초과하면 429 오류가 발생합니다. 애플리케이션에서 지수 백오프 기법을 구현하여 재시도를 처리하십시오.

콘텐츠가 정말 무검열인가요?

이 모델은 합법적인 성인 콘텐츠, 픽션, 보안 연구, 논란이 되는 주제를 거부하지 않습니다. 하지만 미성년자가 관련된 성적 콘텐츠는 항상 차단됩니다. 이 모델은 법적 범위 내에서 창의적인 자유를 위해 설계되었습니다.

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

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

API 키 받기