Seedance API: 단일 엔드포인트를 통한 프롬프트 및 스크립트

사전 준비: SDK 설치

첫 번째 요청을 보내기 전에 선호하는 언어용 공식 OpenAI SDK가 설치되어 있는지 확인하십시오. 이 API는 표준 chat/completions 프로토콜을 사용하므로 모든 OpenAI 호환 클라이언트가 작동합니다. Python의 경우 pip를 통해 패키지를 설치하십시오. Node.js의 경우 npm을 사용하십시오. 기본 텍스트 생성이나 도구 호출에는 클라이언트 라이브러리만 필요하며 추가 종속성은 필요하지 않습니다.

인증: API 키 설정

인증은 간단한 Bearer 토큰을 통해 처리됩니다. API 키 받기 페이지에서 계정을 생성하여 고유한 키를 받으십시오. 체험용에는 신용카드가 필요하지 않습니다. 이 키를 환경 변수나 애플리케이션의 구성 파일에 저장하십시오. 이 키는 무검열 모델에 대한 접근 권한을 제공하며 선불 크레딧 잔액에 연결됩니다. 필요한 경우 대시보드에서 언제든지 키를 재생성할 수 있습니다.

채팅 완성 요청 보내기

기본 URL로 POST 요청을 보내세요. model 필드는 uncensored로 설정해야 합니다. 역할 정의를 위해 시스템 프롬프트를 포함하고, 콘텐츠 생성을 위해 사용자 메시지를 추가하세요. 이 엔드포인트는 스크립트 작성, 캡션 생성, 텍스트 후처리 작업을 효율적으로 처리합니다.

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

실시간 출력을 위한 스트리밍 응답

긴 스크립트나 실시간 캡션의 경우 stream: true를 설정하여 스트리밍을 활성화하세요. API는 부분 완성 응답의 서버 전송 이벤트(SSE) 스트림을 반환합니다. 이를 통해 애플리케이션은 텍스트가 생성되는 대로 표시할 수 있어 지각된 지연 시간을 줄일 수 있습니다. SDK에서 스트림 청크를 처리하여 UI를 단계적으로 업데이트하세요.

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)

구조화된 데이터를 위한 도구 호출 사용

API는 텍스트에서 구조화된 데이터를 추출하거나 JSON 출력을 생성하기 위한 함수 호출을 지원합니다. 요청에 도구 스키마를 정의하십시오. 모델은 코드가 실행할 수 있는 구조화된 인수로 응답합니다. 이는 생성된 스크립트나 메타데이터에서 특정 필드가 필요한 사후 처리 단계에 이상적입니다.

Copyfrom openai import OpenAI

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

제한 사항 및 할당량 이해하기

표준 HTTP 상태 코드를 확인하십시오. 401 오류는 API 키가 유효하지 않거나 만료되었음을 의미합니다. 402 오류는 선불 크레딧이 부족함을 나타내며, 계속하려면 충전해야 합니다. 429 오류는 키당 분당 300개의 요청으로 제한되는 속도 제한을 나타냅니다. 컨텍스트 창은 총 100,000 토큰입니다. 8 MB를 초과하는 요청은 거부됩니다.

Copyimport OpenAI from "openai";

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