오픈 API

빠른 시작

1. 1. 인증: 키를 요청 헤더에 넣기

   curl https://smilesub.xixiaotech.cn/api/v1/me \
     -H "Authorization: Bearer sk_live_여러분의_키"
   
   # 다음 방식도 가능합니다(많은 게이트웨이의 관례적 표기):
   #   -H "X-API-Key: sk_live_여러분의_키"

   키를 URL 파라미터로 넘기는 방식은 지원하지 않습니다. URL은 액세스 로그, 브라우저 기록, Referer에 남기 때문에 장기 유효한 키가 로그에 나타나는 순간 유출과 같습니다.

2. 2. 일반적인 흐름(오디오 → 자막 → 다운로드)

   # ① 오디오를 업로드하고 작업을 생성합니다(Content-Length 헤더가 필요합니다. 본문은 multipart가 아니라 raw 바이너리입니다)
   curl -X POST "https://smilesub.xixiaotech.cn/api/v1/subtitles?language=zh" \
     -H "Authorization: Bearer sk_live_여러분의_키" \
     -H "Content-Type: audio/wav" \
     -H "X-Filename: product-intro.wav" \
     --data-binary @audio.wav
   # → { "success": true, "data": { "file_id": "…", "status": "queued", "credits_charged": 30 } }
   
   # ② has_subtitles가 true가 될 때까지 상태를 폴링합니다
   curl "https://smilesub.xixiaotech.cn/api/v1/tasks/FILE_ID" \
     -H "Authorization: Bearer sk_live_여러분의_키"
   
   # ③ 자막을 다운로드합니다(srt/vtt/txt는 무료, ass와 이중 자막은 회당 과금)
   curl -o out.srt "https://smilesub.xixiaotech.cn/api/v1/tasks/FILE_ID/export?format=srt" \
     -H "Authorization: Bearer sk_live_여러분의_키"

   먼저 ffmpeg로 오디오를 추출한 뒤 업로드하세요(ffmpeg -i in.mp4 -vn -ac 1 -ar 16000 out.wav). 웹 버전의 본 흐름도 같습니다. 서버는 보통 영상 전체를 다루지 않습니다.

3. 3. 동기 번역(여러 언어를 한 번에 제출)

   curl -X POST https://smilesub.xixiaotech.cn/api/v1/translate \
     -H "Authorization: Bearer sk_live_여러분의_키" \
     -H "Content-Type: application/json" \
     -d '{
       "srt": "1\n00:00:00,000 --> 00:00:03,000\n안녕하세요\n",
       "source_language": "ko",
       "target_languages": ["en", "ja"],
       "output": "srt"
     }'
   # → { "success": true, "data": { "translations": { "en": { "content": "…" }, "ja": { "content": "…" } },
   #                                "credits_charged": 6, "balance_after": 994 } }

엔드포인트 목록