Suno API: 하나의 엔드포인트를 통한 프롬프트 및 스크립트

인증 및 기본 URL

당사의 API는 표준 OpenAI 인증을 사용합니다. API 키 가져오기 페이지에서 생성한 API 키만 있으면 됩니다. 시작하기 위해 전화번호나 신용카드가 필요하지 않으며, 모든 신규 계정에는 7일 동안 유효한 $0.50의 무료 체험 크레딧이 제공됩니다.

클라이언트 설정에서 기본 URL을 https://api.sunoapis.com/v1로 설정하세요. 모든 요청에 반드시 전송해야 하는 모델 식별자는 uncensored입니다. 이 모델은 당사 자체 GPU 서버에서 호스팅되며, 주요 제공업체에서 흔히 보이는 거부 반응 없이 합법적인 성인용 및 창작 용도에 맞게 조정된 오픈 웨이트 모델입니다.

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

첫 번째 요청

표준 채팅 완료 요청으로 즉시 시작하세요. 이 엔드포인트는 시스템 프롬프트, 사용자 지시사항 및 텍스트-비디오 또는 AI 음악 파이프라인에 필요한 모든 메타데이터를 포함하는 JSON 페이로드를 받습니다.

이 API는 텍스트 전용입니다. 오디오, 비디오 또는 이미지를 생성하지 않으며, 이러한 도구를 구동하는 텍스트 지시사항을 생성합니다. 이 엔드포인트를 사용하여 장면을 대본으로 작성하거나, 가사를 작성하거나, 크리에이티브 애셋에서 구조화된 데이터를 추출하세요.

Copycurl https://api.sunoapis.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 SDK

공식 OpenAI SDK를 사용하여 Python 애플리케이션에 API를 통합하세요. 당사는 OpenAI 호환이므로 Base URL과 API 키만 변경하면 기존 코드를 재사용할 수 있습니다.

이 방법은 비디오 생성 도구용 스크립트 생성이나 음악 API용 메타데이터 작성에 적합합니다. 다음 섹션에서 설명하는 스트리밍 및 함수 호출 기능을 지원하려면 SDK 버전을 최신 상태로 유지하세요.

Copyfrom openai import OpenAI

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

JavaScript/TypeScript 개발자의 경우, @anthropic-ai/sdk 또는 공식 openai 패키지는 약간의 구성 조정으로 작동합니다. 클라이언트를 Base URL로 지정하고 uncensored 모델 ID를 사용하세요.

이를 통해 크리에이티브 앱용 서버 측 텍스트 생성을 구축할 수 있습니다. 오디오 또는 비디오 생성 엔드포인트로 전송하기 전에 사용자 입력을 전처리하거나 생성된 스크립트를 후처리하는 데 사용할 수 있습니다. API는 현대 웹 프레임워크와 호환되는 표준 JSON 응답을 반환합니다.

Copyimport OpenAI from "openai";

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

스트리밍 응답

긴 스크립트나 상세한 메타데이터의 경우 서버 전송 이벤트(SSE)를 사용하여 토큰을 실시간으로 받으세요. 요청 본문에 stream: true를 설정하세요. API는 청크 시리즈를 전송하여 텍스트가 생성되는 대로 표시할 수 있게 합니다.

사용자가 프롬프트가 작성되는 과정을 보고자 하는 상호작용형 크리에이티브 도구에서 특히 유용합니다. 각 청크에는 변경된 텍스트만 포함되므로 전체 응답을 복원하려면 조각을 연결해야 합니다.

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 키가 제한되며, 이 키는 언제든지 재생성할 수 있습니다(기존 키는 무효화됨). 키당 분당 300개의 요청이 허용되며, 최대 요청 본문 크기는 8 MB입니다.

일반적인 오류로는 유효하지 않은 키에 대한 401, 선불 크레딧이 부족할 때의 402, 그리고 속도 제한에 대한 429이 있습니다. 이 모델은 입력과 출력을 합쳐 100,000개의 토큰의 컨텍스트 창을 지원합니다.

콘텐츠 참고: 모델은 논쟁적이거나 성인 주제를 거부하지 않지만, 모든 요청에서 미성년자가 관련된 성 콘텐츠는 엄격히 차단합니다.