Genel API kapsamı

Tasarım kuralı

Ham dahili uygulama yolları yerine kararlı iş akışı eylemleri sunun. Filtrelenmiş OpenAPI sözleşmesini ancak kimlik doğrulama, istek kimlikleri, idempotans, hız sınırları ve faturalandırma kuralları kararlı olduktan sonra yayımlayın.

• Filtrelenmiş genel OpenAPI v1 sözleşmesini okuyun.

Mevcut genel API v1 kapsamı

Onaylı beta belirteçleri harcamasız teklif ve deneme işleri sunar. Çıktı listesi boştur, ödeme URL’si oluşturulmaz. API anahtarları ve gerçek ücretli yürütme sınırlıdır; plan satın almak geliştirici erişimini otomatik onaylamaz.

Yetenek keşfi herkese açık ve salt okunurdur. Diğer tüm işlemler onaylı beta belirteci gerektirir; web oturumu veya ücretli abonelik tek başına geliştirici erişimi sağlamaz.

Beta onayından sonra Authorization: Bearer <token> veya X-Vietls-API-Key: <token> gönderin.

Sorun giderme için yanıttaki X-Request-ID ve requestId değerlerini saklayın. Bunlar isteği tanımlar ve işlemin idempotencyKey değerinin yerini tutmaz.

İstek örneği: teklif kimliğini döndürülen değerle değiştirin. Her yeni işlem için benzersiz bir idempotans anahtarı kullanın ve aynı işlemi yeniden denerken bu anahtarı yeniden kullanın.

• GET /api/public/v1/capabilities — Bu herkese açık salt okunur uç noktadan kullanılabilir iş akışlarını keşfedin.
• POST /api/public/v1/quotes — Kredi harcamayan ve iş oluşturmayan teklif önizlemeleri isteyin.

  {
    "workflowId": "prproj.subtitle.extract",
    "units": 1
  }

• POST /api/public/v1/jobs — Döndürülen teklif kimliği, idempotans anahtarı, açık teklif kabulü ve kullanıcı onayıyla belirlenimci, harcamasız bir deneme işi oluşturun. Sonuç kimliği job_preview_* biçimindedir.

  {
    "workflowId": "prproj.subtitle.extract",
    "quoteId": "quote_preview_01234567",
    "idempotencyKey": "example-job-001",
    "confirmation": {
      "quoteAccepted": true,
      "userConfirmed": true
    }
  }

• GET /api/public/v1/jobs/{jobId} — Döndürülen job_preview_* kimliğini sorgulayın ve boş çıktılarla completed_preview durumunu işleyin.
• GET /api/public/v1/jobs/{jobId}/artifacts — Boş artifacts listesi bir deneme işinin beklenen son sonucudur.
• GET /api/public/v1/jobs/{jobId}/artifacts/{artifactId}/download-url — İndirme URL’sini yalnızca tamamlanan gerçek işler çıktı sunduktan sonra isteyin. Deneme çıktıları PUBLIC_API_ARTIFACT_NOT_FOUND döndürür.
• GET /api/public/v1/usage — Harcama yapılmadığını denetleyin: deneme kullanımı sıfır ayrılmış ve sıfır harcanmış kredi bildirir.
• POST /api/public/v1/billing/simulations — Muhasebe kaydını değiştirmeden rezervasyon, tahsilat ve serbest bırakmayı doğrulamak için scenario: "success" ve scenario: "provider_failure" deneyin. Üç onay bayrağı da doğru olmalıdır.

  {
    "workflowId": "prproj.subtitle.extract",
    "quoteId": "quote_preview_01234567",
    "idempotencyKey": "example-simulation-001",
    "scenario": "success",
    "confirmation": {
      "quoteAccepted": true,
      "userConfirmed": true,
      "billingSimulationAccepted": true
    }
  }

• POST /api/public/v1/checkout/handoffs — Üç kullanıcı onayı da doğru olduğunda ödeme yönlendirmesini doğrulayın. Önizleme checkoutUrl: null döndürür, ücret almaz ve sağlayıcı oturumu veya abonelik oluşturmaz.

  {
    "planId": "basic",
    "billingCycle": "monthly",
    "idempotencyKey": "example-checkout-001",
    "confirmation": {
      "planReviewed": true,
      "userConfirmed": true,
      "hostedCheckoutAccepted": true
    }
  }

Planlanan genel işlemler

• Gerçek ödeme URL’lerini yalnızca izin verilen dönüş URL’leri ve ilk satın alma kontrolleri geçildikten sonra etkinleştirin.
• Tamamlanmış gerçek işlerin çıktılarını yalnızca depolama, saklama süresi ve tahsilat veya kredi serbest bırakma kontrollerinden sonra açın.

Otomatikleştirilecek kurgu işleri

• prproj.subtitle.extract — PRPROJ altyazı çıkarma

  Web aracı açık · API/MCP beta entegrasyonu hazırlanıyor

  Altyazı ve grafik metnini web aracında inceleyin; otomasyon için geliştirici erişimi isteyin.

• prproj.xml.inspect — PRPROJ XML aktarımı ve onarımı

  Web aracı açık · genel iş arayüzü planlanıyor

  XML aktarımı, sürüm işareti kontrolü, yol onarımı ve alıcı editörde doğrulama hazırlığı için dönüştürücüyü kullanın.

• subtitle.translate — Altyazı çevirisi

  Uygulamada mevcut · genel teklif/iş arayüzü planlanıyor

  Sağlayıcı maliyeti olan çeviriden önce teklif alın; dosyadan çıkarılan metni ajan talimatı olarak görmeyin.

• tts.standard.generate — Standart metinden konuşma

  Yönetilen sağlayıcı bağlantısı dağıtım aşamasında

  API veya MCP ile ücretli üretimi açmadan önce teklif, rezervasyon, yürütme, kesinleştirme veya iade adımları doğrulanır.

• youtube.transcript.fetch — YouTube döküm ve medya alımı

  Uygulamada mevcut · hak onaylı otomasyon hazırlanıyor

  Açık meta verileri veya dökümleri yalnızca desteklenen kaynak ve kullanım hakkı onayı politikaları içinde alın.

Hata modeli

Mevcut beta yanıtları şu hata kodlarını içerir:

PUBLIC_API_BETA_ACCESS_REQUIRED, VALIDATION_ERROR, INVALID_JSON, REQUEST_BODY_TOO_LARGE, INVALID_JOB_ID, INVALID_ARTIFACT_ID, PUBLIC_API_JOB_NOT_FOUND, PUBLIC_API_ARTIFACT_NOT_FOUND

Daha geniş genel sözleşmede bu kodlar da planlanır; liste, tüm koşulların mevcut betada uygulandığı anlamına gelmez.

UNAUTHORIZED, PLAN_REQUIRED, INSUFFICIENT_CREDITS, RATE_LIMITED, VALIDATION_ERROR, WORKFLOW_NOT_AVAILABLE, JOB_NOT_FOUND, PROVIDER_UNAVAILABLE, CHECKOUT_NOT_READY