Transliterator API

27개 이상의 문자 체계를 즉시 라틴 문자로 변환 - SEO 슬러그, 정규화된 검색 및 데이터 파이프라인에 적합.

API FAQ
API 키 받기 크레딧 구매
무엇을 할 수 있나요?
검색 정규화

혼합 문자 콘텐츠를 통합적으로 인덱싱 및 검색.

SEO 슬러그

깨끗한 다국어 URL을 즉시 생성.

데이터 파이프라인

일관된 텍스트로 카탈로그나 NLP 워크플로 공급.

라이브 테스트
99.9 % 가동 시간
12.5ms 응답
20 req/s
0.009 크레딧 / 요청 ⓘ

Transliterator API 


POST https://api.yeb.to/v1/transliterator
매개변수 유형 필수 설명
api_key string 예 Auth key
lang string 선택 ISO code of input script
text string 예 Input text (max. 255 chars)
type string 선택 plain | slug | snake | camel | capital | upper | lower
delimiter string 선택 Custom delimiter for slug/snake

요청 예시

{
  "api_key":"YOUR_KEY",
  "lang":"bg",
  "text":"пример"
}
{
  "api_key":"YOUR_KEY",
  "lang":"ru",
  "text":"тест транслитерация",
  "type":"slug",
  "delimiter":"_"
}

API 연동

curl -X POST https://api.yeb.to/v1/transliterator \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY","lang":"bg","text":"пример","type":"slug","delimiter":"-"}'
Route::post('/transliterate', function () {
    $data = Http::post('https://api.yeb.to/v1/transliterator', [
        'api_key'   => config('services.transliterator.key'),
        'lang'      => 'bg',
        'text'      => 'пример',
        'type'      => 'slug',
        'delimiter' => '-',
    ]);
    return $data->json();
});
$r = Http::post('https://api.yeb.to/v1/transliterator', [
    'api_key'=>'YOUR_KEY','lang'=>'bg','text'=>'пример',
    'type'=>'slug','delimiter'=>'-'
]);
echo $r->json();
fetch('https://api.yeb.to/v1/transliterator', {
  method:'POST',
  headers:{'Content-Type':'application/json'},
  body:JSON.stringify({api_key:'YOUR_KEY',lang:'bg',text:'пример',type:'slug',delimiter:'-'})
}).then(r=>r.json()).then(console.log);
import requests, json
payload = {"api_key":"YOUR_KEY","lang":"bg","text":"пример","type":"slug","delimiter":"-"}
r = requests.post('https://api.yeb.to/v1/transliterator', headers={'Content-Type':'application/json'},
                  data=json.dumps(payload))
print(r.json())

Response Example

{
  "result":"primer","original":"пример","lang":"bg",
  "type":"slug","delimiter":"-","response_code":200,"response_time_ms":37
}
{
  "error":"Invalid API key","code":401,
  "response_code":401,"response_time_ms":12
}

응답 코드

코드설명
200 Success요청 처리 완료.
400 Bad Request입력 유효성 검사 실패.
401 UnauthorizedAPI 키 누락 또는 오류.
403 Forbidden키 비활성 또는 허용되지 않음.
429 Rate Limit요청이 너무 많습니다.
500 Server Error예기치 않은 오류.

transliterate

transliterator 0.0090 credits

Parameters

API Key
query · string · required
Language
query · string
Text
query · string · required
Output type
query · string
Delimiter
query · string

Code Samples


                
                
                
            


            

                
Response

                

                    Status: —
                

                

                    
Headers

                    

                

                

                    
Body

                    

                

            

        

    




                        

                                    

            

        


        
               

     
                            

  
  

    

      Transliterator API — Practical Guide
    

    

      A hands-on guide to Transliterator API: what it does, when to use each mode,
      the parameters that actually matter, and how to read responses for SEO slugs, filenames, app identifiers, and more.
    

    

      Last updated: 07 3월 2026, 08:41
      API Version: v1
      Burst: 20 req/s
              Latency: 12.5 ms
                    Cost: 0.009 credits/req
          

  


  
  

    

    

      
      

        #What Transliterator solves
      

      

        Send a text in any supported script (e.g., Cyrillic, Greek) and get a clean Latin version and/or a
        specific formatting: slug, snake_case, camelCase, Capital Case, UPPER, or lower.
        Perfect for SEO URLs, file/ID normalization, search indexing, and consistent UI labels.
      


      
      

        #Endpoint & when to use it
      


      

        #POST https://api.yeb.to/v1/transliterator
      

      
    
        
  • Best for: Turning any input into a safe, predictable string for URLs, filenames, database keys, and user-facing titles.
    • 
        
  • How it works: We transliterate to Latin and then apply the chosen type transform (slug/snake/camel/etc.).
    • 
        
  • Idempotent: Same input parameters → same output; safe to cache.
    • 
      


      
      

        #Quick start
      


      

        

# Plain transliteration (auto-detect language)
curl -X POST "https://api.yeb.to/v1/transliterator" \
  -H "Content-Type: application/json" \
  -d '{ "api_key": "YOUR_KEY", "text": "пример" }'

      


      

        

# SEO slug with custom delimiter
curl -X POST "https://api.yeb.to/v1/transliterator" \
  -H "Content-Type: application/json" \
  -d '{ "api_key": "YOUR_KEY", "lang": "ru", "text": "тест транслитерация", "type": "slug", "delimiter": "_" }'

      


      
      

        #Parameters that actually matter
      


      

        

          
ParamRequiredWhat to pass in practiceWhy it matters

          
          

            api_key
            Yes
            Send from server/edge. Don’t expose raw keys in client JS.
            Auth & rate limiting.
          

          

            text
            Yes
            Up to 255 chars; emojis and unsupported symbols are stripped.
            Primary content to process.
          

          

            lang
            No
            ISO code of input script (e.g., bg, ru, el). If omitted, we auto-detect.
            Improves accuracy for ambiguous inputs.
          

          

            type
            No
            plain | slug | snake | camel | capital | upper | lower
            Choose the output format you need.
          

          

            delimiter
            No
            Use with slug/snake to set the separator (default - for slug, _ for snake).
            Brand-consistent URLs and identifiers.
          

          
        

      


      

        #Choosing the right type
      

      

        

          
TypeUse it forNotes

          
          
plainReadable Latin outputNo case/spacing changes; punctuation trimmed.

          
slugSEO URLsLowercase, spaces → delimiter, trims duplicates: пример тест → primer-test.

          
snakeDatabase keys, filenamesLowercase + _ (or custom delimiter).

          
camelCode identifiersprimerTest style.

          
capitalUI labelsPrimer Test title case.

          
upperSorting / normalizationAll caps.

          
lowerCase-insensitive searchAll lowercase.

          
        

      


      
      

        #Reading & acting on responses
      


      

        

{
  "result": "primer",
  "original": "пример",
  "lang": "bg",
  "type": "slug",
  "delimiter": "-",
  "response_code": 200,
  "response_time_ms": 37
}

      


      
    
        
  • result — the processed string; use this directly in URLs/keys/UI.
    • 
        
  • original — what you sent (after trimming); handy for logs and idempotency checks.
    • 
        
  • lang — detected or provided language; helps debug unexpected mappings.
    • 
        
  • type, delimiter — echo of your chosen transform; store alongside to rebuild exactly.
    • 
      


      

        #Typical errors & how to fix
      

      

        

{ "error": "Missing \"text\" parameter", "code": 422 }

      

      

        

{ "error": "Unsupported type: foo", "code": 422 }

      

      
    
        
  • 422 missing/invalid: Provide text; ensure type ∈ allowed list.
    • 
        
  • 401 invalid key: Rotate your key; send from server/edge only.
    • 
        
  • 413 too long: Keep text ≤ 255 chars; pre-trim user input.
    • 
      


      
      

        #Troubleshooting & field notes
      

      
    
        
  1. Unexpected characters: Emojis/symbols are removed; if you need them, store the original separately.
    2. 
        
  2. Spaces & dashes: For slug/snake we collapse repeated separators (-- → -).
    3. 
        
  3. Custom brand separators: Use delimiter to enforce _, ., or even no delimiter.
    4. 
        
  4. Language ambiguity: Specify lang when inputs can be mixed (e.g., Serbian Cyrillic vs. Russian).
    5. 
        
  5. Batching: For bulk imports, keep requests ≤ 100 rps and reuse connections; cache deterministic results.
    6. 
      


      
      
      

        #API Changelog
      

      

        

          
2025-10-20

          

            Added capital output type and improved auto-detection for mixed scripts.
            Normalized duplicate separators in slug/snake.
          

        

        

          
2025-10-12

          

            Custom delimiter now supported for both slug and snake.
            Minor Cyrillic → Latin mapping refinements (BG/RU).
          

        

        

          
2025-10-01

          

            Public v1 release with plain, slug, snake, camel, upper, lower.
            Max input length set to 255 chars.
          

        

      

    

  



                    



        
                            

                

                    

                        
                        자주 묻는 질문
                    

                

                

                    

                        

                                                                                                

    

        
    


    

        

            아랍어, 키릴 문자, 그리스어, 히브리어, CJK를 포함한 25개 이상의 문자 체계에 대한 완전한 음역을 지원합니다. 다른 언어가 필요하시면 연락 주세요.
        

    



                                                                    

    

        
    


    

        

            ISO 또는 사실상의 웹 표준을 사용합니다. 일반 어휘에 대해 보통 95% 이상의 정확도.
        

    



                                                                                                                                                            

    

        
    


    

        

            예. 오류가 발생한 요청을 포함하여 모든 요청은 크레딧을 소비합니다. 크레딧은 성공 또는 실패와 관계없이 요청 수에 연결됩니다. 오류가 당사 플랫폼 문제로 인한 것이 분명한 경우 영향을 받은 크레딧을 복원합니다(현금 환불 없음).
        

    



                                                                    

    

        
    


    

        

            [email protected]로 문의하세요. 피드백을 진지하게 받아들입니다—버그 리포트나 기능 요청이 의미 있는 경우 API를 빠르게 수정하거나 개선하고 감사의 표시로 50 무료 크레딧을 제공합니다.
        

    



                                                                    

    

        
    


    

        

            API와 때로는 엔드포인트에 따라 다릅니다. 일부 엔드포인트는 외부 소스의 데이터를 사용하며 더 엄격한 제한이 있을 수 있습니다. 남용을 방지하고 플랫폼 안정성을 유지하기 위해 제한도 적용합니다. 각 엔드포인트의 구체적인 제한은 문서를 확인하세요.
        

    



                                                                    

    

        
    


    

        

            크레딧 시스템으로 운영됩니다. 크레딧은 API 호출과 도구에 사용하는 선불, 환불 불가 단위입니다. 크레딧은 FIFO(오래된 것부터) 방식으로 소비되며 구매일로부터 12개월간 유효합니다. 대시보드에 각 구매 날짜와 만료일이 표시됩니다.
        

    



                                                                    

    

        
    


    

        

            예. 구매한 모든 크레딧(소수 잔액 포함)은 구매일로부터 12개월간 유효합니다. 미사용 크레딧은 유효 기간 종료 시 자동으로 만료되어 영구 삭제됩니다. 만료된 크레딧은 복원하거나 현금 또는 기타 가치로 전환할 수 없습니다. 경과 규칙: 2025년 9월 22일 이전에 구매한 크레딧은 2025년 9월 22일에 구매한 것으로 처리되어 2026년 9월 22일에 만료됩니다(구매 시 더 이른 만료일이 명시되지 않은 한).
        

    



                                                                    

    

        
    


    

        

            예—유효 기간 내에서 이월됩니다. 미사용 크레딧은 계속 사용 가능하며 구매 후 12개월 만료까지 매월 이월됩니다.
        

    



                                                                    

    

        
    


    

        

            크레딧은 환불 불가입니다. 필요한 만큼만 구매하세요—나중에 언제든 충전할 수 있습니다. 플랫폼 오류로 인해 청구가 실패한 경우 조사 후 영향을 받은 크레딧을 복원할 수 있습니다. 현금 환불 없음.
        

    



                                                                    

    

        
    


    

        

            가격은 달러가 아닌 크레딧으로 설정됩니다. 각 엔드포인트에는 자체 비용이 있습니다—위의 "크레딧 / 요청" 배지를 참조하세요. 항상 정확한 지출 금액을 알 수 있습니다.
        

    



                                                                                    

                    

                

            

        
                
            ← API로 돌아가기