Seedream API 설명: AI 워크플로우를 위한 텍스트 엔진

Seedream API란 무엇입니까?

Seedream API는 창의적 및 기술적 파이프라인 내에서 텍스트 생성 작업에 특화된 호스팅된 무검열 대규모 언어 모델(LLM) 서비스입니다. 일반적인 채팅 인터페이스와 달리 이 API는 일반적인 모델에서 발견되는 콘텐츠 거부 없이 프롬프트 엔지니어링, 캡션 및 메타데이터 추출의 미묘한 요구 사항을 처리하도록 설계되었습니다. 시각 미디어와 관련된 워크플로우를 특히 지원합니다.

핵심적으로 이 API는 성인 및 창의적 콘텐츠에 맞게 조정된 오픈 웨이트 모델을 사용하며, 광범위한 청중을 위해 설계된 안전 레일이 특정 비전을 필터링하지 않도록 보장합니다. 서버 전송 이벤트(SSE)를 통한 스트리밍 및 함수 호출을 지원하여 텍스트를 입력하고 텍스트를 출력합니다. 이는 이미지 생성기용 프롬프트 생성 또는 보이스오버 스크립팅과 같은 하류 프로세스를 구동하기 위해 신뢰할 수 있고 결정적인 텍스트 출력이 필요한 개발자에게 이상적입니다.

텍스트 vs 이미지: 역할 이해하기

많은 개발자가 텍스트 모델의 역할과 이미지 생성 모델의 역할을 혼동합니다. Seedream API는 이미지, 오디오 또는 비디오를 생성하지 않습니다. 이러한 모델을 구동하는 텍스트 지시를 생성합니다. 일반적인 Stable Diffusion 워크플로우에서 텍스트 모델은 사용자 의도를 해석하고, 간단한 아이디어를 상세한 프롬프트로 확장하며, 피드백을 기반으로 프롬프트를 정제하는 역할을 합니다.

• 프롬프트 엔지니어링: API는 "사이버펑크 도시"와 같은 간단한 개념을 조명, 카메라 앵글 및 스타일 설명자가 포함된 상세한 프롬프트로 확장합니다.
• 사후 처리: 생성된 이미지(외부 OCR 또는 비전 모델을 통해)를 분석하고 캡션 또는 메타데이터를 생성할 수 있습니다.
• 스크립팅: 비디오 파이프라인의 경우 장면 설명 및 대화 스크립트를 생성합니다.

이러한 관심사의 분리는 최고의 이미지 모델을 선택하면서도 텍스트 생성을 유연하고 무검열 상태로 유지할 수 있게 합니다. Seedream API는 작업의 두뇌 역할을 하며, 이미지 모델은 손 역할을 합니다.

무검열 텍스트의 중요성

표준 LLM은 창의적이거나 성인 주제 작업에 방해가 될 수 있는 콘텐츠 필터를 종종 적용합니다. 예를 들어, 모델은 "거대한 조각상"을 설명하는 것을 거부할 수 있는데, 이는 "거대한"이라는 단어를 감지하고 성적인 맥락으로 간주하기 때문입니다. Seedream API는 합법적인 성인 사용에 대해 이러한 거부 없이 답변하도록 조정되어 창의적 비전이 임의로 차단되지 않도록 보장합니다.

보안 연구원이나 논쟁적인 주제를 탐구하는 작가에게 이 API는 의도를 두 번 생각하지 않는 신뢰할 수 있는 텍스트 엔진을 제공합니다. 기업 검토 필터 없이 텍스트 출력이 입력을 정확히 반영하기를 원하는 전문가를 위한 실용적인 도구입니다.

사용 사례: SD용 프롬프트 생성

Seedream API의 가장 일반적인 사용 사례 중 하나는 Stable Diffusion을 위한 고품질 프롬프트 생성입니다. Stable Diffusion 모델은 구조화되고 설명적인 텍스트에 가장 잘 반응합니다. API는 거친 아이디어를 받아 스타일, 조명 및 구성에 대한 특정 키워드가 포함된 상세한 프롬프트로 확장할 수 있습니다.

예를 들어 "a futuristic car"라는 프롬프트를 보내면 "A sleek, neon-lit futuristic sports car, cyberpunk aesthetic, rain-slicked streets, volumetric lighting, 8k, highly detailed, unreal engine 5 render."와 같이 상세한 결과를 받을 수 있습니다. 이러한 세부 사항은 생성된 이미지의 품질을 크게 향상시킵니다.

API는 함수 호출을 지원하여 생성된 JSON을 이미지 생성 파이프라인에서 직접 사용할 수 있도록 구조화할 수 있습니다. 이는 텍스트 파싱을 위한 후처리 필요성을 줄여 워크플로우를 더 빠르고 신뢰할 수 있게 만듭니다. 수천 가지 변형을 생성하든 소수만 생성하든 무검열 모델은 특정 스타일 선택이 필터링되지 않도록 보장합니다.

사용 사례: 메타데이터 및 캡션

프롬프트 생성 외에도 Seedream API는 사후 처리 텍스트 작업에 탁월합니다. 대규모 이미지 또는 비디오 데이터셋이 있는 경우 API를 사용하여 정확한 캡션 및 메타데이터를 생성할 수 있습니다. 이는 검색 가능한 라이브러리를 구축하거나 사용자 정의 모델을 훈련하는 데 특히 유용합니다.

예를 들어 이미지 콘텐츠의 설명을 제공하면 API는 SEO 또는 데이터베이스 인덱싱에 적합한 간결하고 키워드가 풍부한 캡션을 생성합니다. 100,000개의 토큰 컨텍스트 창을 사용하면 단일 요청에서 텍스트의 큰 블록이나 여러 이미지에 해당하는 메타데이터를 처리하여 지연 시간과 비용을 줄일 수 있습니다.

이 기능은 비디오 파이프라인을 위한 스크립팅으로 확장됩니다. API는 장면 설명, 캐릭터 대화 및 보이스오버 스크립트를 생성하며, 모두 특정 창의적 방향에 맞게 조정됩니다. 무검열 특성은 스크립트의 성숙한 주제가 오류로 플래그되지 않도록 하여 더 진정한 스토리텔링을 가능하게 합니다.

OpenAI SDK와의 통합

Seedream API는 OpenAI 호환이므로 OpenAI API 형식을 지원하는 모든 라이브러리나 도구와 함께 사용할 수 있습니다. 여기에는 공식 Python SDK, JavaScript SDK 및 많은 서드파티 도구가 포함됩니다. 구성 파일의 기본 URL과 API 키만 업데이트하면 됩니다.

• 기본 URL: https://api.sdxlapi.com/v1
• 모델 ID: uncensored
• 엔드포인트: POST /v1/chat/completions

이 호환성 덕분에 텍스트 모델을 교체해도 전체 파이프라인을 다시 작성할 필요가 없습니다. 현재 프롬프트 생성에 다른 LLM을 사용하고 있다면 Seedream API로 최소한의 코드 변경으로 전환할 수 있습니다. API는 SSE를 통한 스트리밍도 지원하므로 텍스트가 생성되는 대로 실시간 애플리케이션에 표시해야 할 때 유용합니다.

함수 호출도 지원되므로 모델이 데이터를 가져오거나 작업을 수행하는 데 사용할 수 있는 사용자 정의 도구를 정의할 수 있습니다. 이를 통해 동적 데이터 통합이 필요한 복잡한 워크플로우에 API를 다양하게 활용할 수 있습니다.

성능과 컨텍스트 창

Seedream API는 100,000개의 토큰 컨텍스트 창을 제공하며, 이는 많은 표준 모델보다 훨씬 큰 규모입니다. 이를 통해 단일 요청으로 대용량 문서, 긴 스크립트 또는 광범위한 이미지 메타데이터를 처리할 수 있습니다. 예를 들어, 50페이지 분량의 스크립트를 API에 입력하여 캐릭터 프로필, 장면 요약, 대화 수정을 한 번에 생성할 수 있습니다.

API는 키당 분당 최대 300개의 요청을 지원하므로 대부분의 배치 처리 작업에 충분합니다. 최대 요청 본문 크기는 8 MB로, 제한에 도달하지 않고도 큰 페이로드를 보낼 수 있습니다. 대부분의 사용 사례에서 이는 실시간 및 배치 작업 모두에 충분한 용량을 제공합니다.

성능은 텍스트 생성에 최적화되어 있으며, 간단한 프롬프트의 경우 지연 시간이 짧고 복잡한 다단계 추론 작업의 경우 약간 더 오래 걸립니다. 무검열 모델은 속도와 정확도를 위해 조정되어 파이프라인이 텍스트 생성에서 병목 현상이 발생하지 않도록 합니다. 더 높은 처리량이 필요한 경우 여러 API 키를 생성하여 요청을 분산할 수 있습니다.

가격 및 확장성

Seedream API는 월 구독료나 구독 모델이 없는 투명하고 사용한 만큼 지불하는 가격 모델을 사용합니다. 비용은 입력 토큰 100만 개당 $0.25, 출력 토큰 100만 개당 $1.00입니다. 이는 전송하고 받는 텍스트에 대해서만 지불한다는 의미로, 소규모 프로젝트부터 대규모 파이프라인까지 비용 효율적입니다.

예를 들어, 10,000개의 상세한 이미지 프롬프트를 생성하는 데 드는 비용은 입력 시 약 $0.01, 출력 시 약 $0.05로 총 $0.06입니다. 이러한 낮은 비용으로 인해 높은 청구 금액을 걱정하지 않고 다양한 프롬프트 구조와 스타일을 자유롭게 실험할 수 있습니다.

계정은 최소 $10부터 충전할 수 있으며, 더 큰 금액을 입금할 경우 보너스가 제공됩니다: $50 입금 시 +5%, $100 입금 시 +10% 보너스 크레딧이 제공됩니다. 선불 크레딧은 만료되지 않으므로 잔액을 쌓아 시간이 지남에 따라 사용할 수 있습니다. 신규 계정은 신용카드 없이 $0.50의 무료 체험 크레딧을 7일 동안 받을 수 있어 API를 사용하기 전에 테스트할 수 있습니다.

첫 번째 요청 시작하기

Seedream API 시작은 간단합니다. 먼저 "API 키 받기" 페이지에서 이메일과 비밀번호만으로 계정을 등록하세요. 무료 체험을 위해 전화번호나 신용카드가 필요하지 않습니다. 등록이 완료되면 API 키가 즉시 표시됩니다.

다음으로, 기본 URL https://api.sdxlapi.com/v1과 API 키를 사용하여 OpenAI 호환 클라이언트를 구성합니다. 그런 다음 모델 ID "uncensored"를 사용하여 /v1/chat/completions 엔드포인트로 요청을 보낼 수 있습니다. Python SDK를 사용한 간단한 예제는 다음과 같습니다:

API는 스트리밍, 함수 호출, 표준 채팅 완료를 지원하므로 어떤 워크플로우에도 쉽게 통합할 수 있습니다. API 키는 언제든지 재생성할 수 있으며, 기존 키는 무효화되어 보안을 유지합니다. 프롬프트는 학습에 사용되지 않으며, 계정 프라이버시는 이메일과 비밀번호만으로 보호됩니다.