요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
text | 예 | The words to be spoken, exactly as written. Billed per 1,000 characters. |
pitch | 아니요 | Pitch shift in semitones; 0 keeps the voice's own pitch. ≥ -12 · ≤ 12 · 기본값: 0 |
speed | 아니요 | 말하는 속도. ≥ 0.5 · ≤ 2 · 기본값: 1 |
volume | 아니요 | Loudness multiplier; 1 is the normal level. ≥ 0.5 · ≤ 2 · 기본값: 1 |
language | 아니요 | 읽을 언어. zh · en · ja · es-mx · id · pt-br · ko · it · de · fr |
voice_id | 아니요 | 사용 가능한 목소리 중에서 고릅니다. vivi_mixed_en_zh_ja_es_id · mindy_en_es_id_pt_zh · stokie_en · dacey_en · tim_en · kian_en_zh · cedric_en_zh · sophie_en_zh · jean_en_zh · magnus_en_zh · mabel_en_zh · nadia_en_zh · opal_en_zh · pearl_en_zh · quentin_en_zh · vienna_mixed_en_zh · alina_mixed_en_zh · corinne_mixed_en_zh · esther_mixed_en_zh · freya_mixed_en_zh · gigi_mixed_en_zh · holly_mixed_en_zh · lyla_mixed_en_zh · daisy_mixed_en_zh · tracy_es_zh · jess_ja_es_id_pt_en_zh · pinky_es_ko_mixed_en_zh · sweety_ja_es · sandy_es_mixed_en_zh · sven_de · minimi_ja · usseau_fr · felipe_es · han_id · martins_pt · enzo_it · shane_ko · bonnie_zh · felix_zh · celeste_zh · monkey_king_zh · 기본값: stokie_en |
sample_rate | 아니요 | Sample rate in Hz. The model uses 24000 when omitted. 8000–48000 |
instructions | 아니요 | How to read the text: tone, emotion, pace or volume. Not spoken and not billed. |
output_format | 아니요 | 결과 파일 형식. mp3 · opus · 기본값: mp3 |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /1,000자 | ≈ USD |
|---|---|---|
| 기본 | 10.8 | US$0.11 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 11크레딧/1,000자(US$0.11)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Seed Speech 2.0 API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 bytedance/seed-speech-2.0/text-to-speech, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seed-speech-2.0/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"voice_id": "stokie_en",
"output_format": "mp3"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.
Seed Speech 2.0 API 질문
Seed Speech 2.0 API 요금은 얼마인가요?
Seed Speech 2.0 가격은 11크레딧(US$0.11) /1,000자입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Seed Speech 2.0의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 텍스트 음성 변환: bytedance/seed-speech-2.0/text-to-speech을(를) 넣으세요.
낭독 방식은 어떻게 제어하나요?
voice_id로 41가지 프리셋 보이스 중 하나를 선택하고, instructions에 어조·감정·속도·음량 등 낭독 방식을 한두 문장의 평이한 언어로 설명하세요. instructions는 낭독 방식을 결정할 뿐 소리 내어 읽히지 않습니다.
어떤 언어를 읽을 수 있나요?
스크립트의 언어는 자동으로 감지됩니다. language를 사용하면 중국어, 영어, 일본어, 멕시코 스페인어, 인도네시아어, 브라질 포르투갈어, 한국어, 이탈리아어, 독일어, 프랑스어를 강제로 지정할 수도 있습니다. 일부 보이스는 두 가지 이상의 언어를 지원하도록 만들어졌습니다.
실제 인물의 목소리를 복제할 수 있나요?
아니요. 이 엔드포인트에서 사용할 수 있는 것은 41가지 프리셋 보이스뿐이며, 음성 복제나 참조 음성 업로드 기능은 제공하지 않습니다.
Seed Speech 2.0 API의 제한은 무엇인가요?
텍스트 길이(글자): 5,000; 목소리: 41; 언어: 10. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Seed Speech 2.0을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Seed Speech 2.0을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.

