번역 (Translate) API

최첨단 AI를 사용하여 자막을 100개 이상의 언어로 번역하여 도달 범위를 넓히세요.

POST/api/v1/translate

빠른 구현

curl -X POST https://api.srtgen.com/api/v1/translate \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "projectId=proj_8k2n9m1b" \
  -F "targetLanguageCode=es" \
  -F "modelId=pro"

POSThttps://api.srtgen.com/api/v1/translate

요청 파라미터

파라미터	유형	필수 여부	설명
`projectId`	String	Yes	번역할 프로젝트의 고유 식별자입니다.
`targetLanguageCode`	String	Yes	ISO 639-1 코드 (예: 'es', 'fr', 'zh-CN').
`modelId`	String	No	'pro' (고품질, 1크레딧/분) 또는 'basic' (빠름, 1크레딧/2분). 기본값은 'basic'입니다.

고급: 기본 모델 (비용 최적화)

curl -X POST https://api.srtgen.com/api/v1/translate \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "projectId=proj_8k2n9m1b" \
  -F "targetLanguageCode=zh-CN" \
  -F "modelId=basic"

POSThttps://api.srtgen.com/api/v1/translate

성공 응답

성공적인 요청은 200 OK 상태를 반환합니다. 번역된 자막은 즉시 동기화되어 워크스페이스에서 내보내거나 추가 수정이 가능합니다.

{
  "success": true,
  "projectId": "proj_8k2n9m1b",
  "targetLanguageCode": "es",
  "modelId": "pro"
}

오류 코드

파라미터	유형	필수 여부
400	missing_parameter	프로젝트 ID 또는 대상 언어가 누락되었습니다.
401	unauthorized	API 키가 누락되었거나 유효하지 않습니다.
404	not_found	프로젝트 ID가 존재하지 않습니다.
403	insufficient_balance	작업을 위한 크레딧이 부족합니다.
500	translation_failed	AI 엔진이 요청 처리에 실패했습니다.
500	server_error	예기치 않은 내부 서버 오류가 발생했습니다.

오류 응답 구조

{
  "success": false,
  "error": "not_found",
  "message": "ID가 'proj_unknown'인 프로젝트를 찾을 수 없습니다."
}

이 페이지가 도움이 되었나요?