Metin

Çeviri Oluştur

Metni hedef dile çevirir

POST
/v1/translations

Genel Bakış

Metinden metne çeviri için /v1/translations uç noktasını kullanın.

Bu uç nokta, bir ses dosyası kabul eden ve her zaman İngilizce metin çıktısı veren Ses Çevirisi bölümünden farklıdır.

Güncel metin çevirisi modellerini almak için Models API'sini kullanın:

curl "https://api.tokenlab.sh/v1/models?recommended_for=translation"

Ardından seçilen modeli açıkça /v1/translations uç noktasına gönderin.

recommended_for=translation yalnızca metin çevirisi (POST /v1/translations) için geçerlidir. Ses çevirisi için geçerli değildir.

İstek Gövdesi

modelstringzorunlu

/v1/models?recommended_for=translation tarafından döndürülen çeviri modeli ID'si.

textstringzorunlu

Çevrilecek kaynak metin. Girdi uzunluğu sınırı modele bağlıdır; GET /v1/models/{model} içindeki max_input_tokens değerine bakın.

target_languagestringzorunlu

Model desteğine bağlı olarak hedef dil kodu veya dil adı.

source_languagestring

İsteğe bağlı kaynak dil ipucu.

mime_typestringvarsayılan: text/plain

Kaynak metin biçimi: text/plain veya text/html. Bunu yalnızca model ayrıntılarında mime_type listeleniyorsa gönderin.

userstring

Kötüye kullanım izleme ve istek takibi için isteğe bağlı son kullanıcı tanımlayıcısı. Bunu yalnızca model ayrıntılarında user listeleniyorsa gönderin.

Yanıt

textstring

Çevrilen metin.

modelstring

Çeviriyi oluşturan model.

source_languagestring | null

Model tarafından algılanan veya kabul edilen kaynak dil.

target_languagestring

İstek için kullanılan hedef dil.

İstek

curl -X POST "https://api.tokenlab.sh/v1/translations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-translation",
    "text": "你好,欢迎使用 TokenLab。",
    "target_language": "en"
  }'

Yanıt

Response
{
  "text": "Hello, welcome to TokenLab.",
  "model": "doubao-seed-translation",
  "source_language": "zh",
  "target_language": "en"
}

Hatalar

DurumKodNeden
400invalid_requestmodel, text veya target_language eksik veya boş ya da mime_type iki değerden biri değil. param alanı belirtir
400unsupported_endpointModel bu uç nokta için yayınlanmamış

Diğer durumları API hatalarını işleme bölümündeki gibi ele alın.

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

Başlıklar

X-TokenLab-Delivery-Policy?string

İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.

Geçerli değerler

  • "auto"
  • "verified"
  • "official"

İstek gövdesi

application/json

Yanıt

application/json

application/json

application/json

application/json

application/json

application/json