Caption translation
사용 가능Send your timed captions and a language. Get the same lines back translated, in the same order and with the same timings, ready to put on the video.
Caption translation
입력
segmentsThe timed caption lines, each with start, end (seconds) and text.target_languageThe language to translate into.source_languageThe captions' language; leave it out to detect it.$0.00591 per started 1,000 characters.
120 billed characters120 billed characters
1 00:00:00,200 --> 00:00:02,240 สวัสดีและยินดีต้อนรับสู่ร้านกาแฟของเรา 2 00:00:03,040 --> 00:00:05,160 วันนี้เรามีเค้กช็อกโกแลตสดใหม่ 3 00:00:05,880 --> 00:00:06,500 อยากลองชิมไหมครับ?
Language: th
이용 방법
- 01Send the captionsLines with start and end seconds, and a language such as th or ja.
- 02We translate themLine by line, short enough to read.
- 03Get the captionsBilled per 1,000 characters, known up front.
코드에서 Caption translation 호출하기
One endpoint and one key, on the same balance as the playground. The request below is the example's own.
https:/API 키 받기
콘솔에서 키를 만드세요. 플레이그라운드와 같은 잔액을 씁니다.
키 만들기첫 요청 보내기
플레이그라운드가 보내는 것과 같은 요청입니다. OPENNAN_KEY에 키를 넣으세요.
curl https://api.opennan.com/v1/captions/translations \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"segments":[{"start":0.2,"end":2.24,"text":"Hello and welcome to our coffee shop."},{"start":3.04,"end":5.16,"text":"Today we have fresh chocolate cakes."},{"start":5.88,"end":6.5,"text":"Want to try them?"}],"target_language":"th","source_language":"en"}' # Then poll until "status" is "succeeded" or "failed": curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"작업 확인하기
호출하면 바로 작업 ID가 돌아옵니다. 끝날 때까지 작업을 확인하세요:
GEThttps:// api.opennan.com/ v1/ tasks/ {id} - queued
- 워커 대기 중
- running
- 생성 중
- succeeded
- 완료: outputs[].url에 파일이 있습니다
- failed
- 실패: 요금이 청구되지 않습니다
오류와 해결 방법
401키가 없거나 틀림
콘솔에서 만든 키를 Authorization: Bearer 헤더로 보내세요.
402잔액 부족
결제 메뉴에서 잔액을 충전한 뒤 같은 호출을 다시 보내세요.
400받을 수 없는 값
error.message에 필드 이름이 나옵니다. 파라미터 표의 값을 쓰세요.
429요청이 너무 많음
몇 초 기다렸다가 다시 시도하고, 429가 반복되면 더 오래 기다리세요.
AI 앱에 Opennan 추가하기
한 번 설치하면 AI가 Opennan의 모든 도구를 씁니다: 영상, 이미지, 채팅, 음성, 음악, 효과음, 3D, 자막, 더빙. 사용하는 앱을 고르고 단계를 따라 하세요.
https:/Codex CLI, Codex 앱, Codex IDE 확장에서 모두 작동합니다(~/.codex/config.toml 공유). 앱이나 IDE가 OPENNAN_KEY를 못 읽으면 키를 넣은 config.toml 방식을 쓰세요. Codex는 도구를 호출하기 전에 묻습니다. 승인하면 계속됩니다.
키를 OPENNAN_KEY로 저장
# macOS / Linux (zsh shown; bash: ~/.bashrc) echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc source ~/.zshrc # Windows (PowerShell), then open a new terminal setx OPENNAN_KEY "sk-..."Opennan 플러그인 설치: 서버와 함께 모델 선택, 가격 확인, 결과 대기를 AI에게 알려 주는 스킬이 들어 있습니다
codex plugin marketplace add Opennan/opennan-ai-plugin codex plugin add opennan@opennan또는 서버만 추가
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEY또는 ~/.codex/config.toml에 추가
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }opennan이 목록에 있는지 확인
codex mcp listCodex을 다시 시작하고 무엇이든 요청하세요
“네온 거리에 내리는 비 5초 영상, 어울리는 노래, 포스터 이미지를 만들어 줘.”
sk-...를 내 키로 바꾸고 비공개로 두세요. 키를 가진 사람은 잔액을 쓸 수 있습니다. 키가 없어도 도구 목록은 보이지만 만들려면 키가 필요합니다.
AI 에이전트에서 사용하기
에이전트에 Opennan MCP 서버를 추가하고 이 도구를 호출하세요.
- 도구
- translate_captions
- 예시 인수
{ "segments": [ { "start": 0.2, "end": 2.24, "text": "Hello and welcome to our coffee shop." }, { "start": 3.04, "end": 5.16, "text": "Today we have fresh chocolate cakes." }, { "start": 5.88, "end": 6.5, "text": "Want to try them?" } ], "target_language": "th", "source_language": "en" }
Caption translation: 자주 묻는 질문
Caption translation 요금은 얼마인가요?
$0.00591 per 1,000 characters. The Run button shows the exact price for your input before you start.
코드에서 어떻게 호출하나요?
API 키와 함께 POST https://api.opennan.com/v1/captions/translations를 보내세요. 작업 ID가 돌아오면 작업이 성공하거나 실패할 때까지 https://api.opennan.com/v1/tasks/{id}을 확인하세요.
AI 에이전트가 쓸 수 있나요?
네. MCP 서버 https://api.opennan.com/v1/mcp를 추가해 translate_captions 도구를 호출하거나, 에이전트에게 https://api.opennan.com/llms.txt를 알려 주세요.
실행이 실패하면 어떻게 되나요?
실패한 실행은 청구되지 않습니다. 결과에 대해서만 결제합니다.