Beperkte bèta

Bereik van de openbare API

Verschillen tussen stabiele openbare taakinterfaces en interne applicatieroutes.

Ontwerpregel

Bied stabiele werkstroomacties aan in plaats van onbewerkte interne app-routes. Publiceer een gefilterd OpenAPI-contract pas wanneer authenticatie, aanvraag-ID’s, idempotentie, snelheidslimieten en factureringsregels stabiel zijn.

Lees het gefilterde openbare OpenAPI-v1-contract.

Huidig bereik van de openbare API v1

Goedgekeurde bètatokens bieden offertes en testtaken zonder verbruik. Resultaatlijsten zijn leeg en er wordt geen betaal-URL aangemaakt. API-sleutels en betaalde uitvoering zijn beperkt; een abonnement kopen keurt ontwikkelaarstoegang niet automatisch goed.

Het ontdekken van mogelijkheden is openbaar en alleen-lezen. Alle overige bewerkingen vereisen een goedgekeurd bèta-token; webaanmelding of een betaald abonnement alleen geeft geen ontwikkelaarstoegang.

Stuur na bèta-goedkeuring Authorization: Bearer <token> of X-Vietls-API-Key: <token>.

Bewaar X-Request-ID en requestId uit het antwoord voor probleemonderzoek. Ze identificeren de aanvraag en vervangen niet de idempotencyKey van de bewerking.

Voorbeeldaanvraag: vervang de prijsopgave-ID door de ontvangen waarde. Gebruik een unieke idempotentiesleutel per nieuwe bewerking en hergebruik die bij herhaling van dezelfde bewerking.

GET /api/public/v1/capabilities — Ontdek beschikbare werkstromen via dit openbare, alleen-lezen eindpunt.
POST /api/public/v1/quotes — Vraag een prijsvoorbeeld aan dat geen credits verbruikt en geen taak maakt.
```
{
  "workflowId": "prproj.subtitle.extract",
  "units": 1
}
```
POST /api/public/v1/jobs — Maak een deterministische testtaak zonder kosten met de ontvangen prijsopgave-ID, een idempotentiesleutel, expliciete aanvaarding van de prijsopgave en gebruikersbevestiging. Het resultaat heeft een ID job_preview_*.
```
{
  "workflowId": "prproj.subtitle.extract",
  "quoteId": "quote_preview_01234567",
  "idempotencyKey": "example-job-001",
  "confirmation": {
    "quoteAccepted": true,
    "userConfirmed": true
  }
}
```
GET /api/public/v1/jobs/{jobId} — Vraag de ontvangen ID job_preview_* op en behandel completed_preview met lege bestanden.
GET /api/public/v1/jobs/{jobId}/artifacts — Een lege lijst artifacts is het verwachte eindresultaat van een testtaak.
GET /api/public/v1/jobs/{jobId}/artifacts/{artifactId}/download-url — Vraag pas een download-URL aan wanneer voltooide echte taken bestanden bieden. Testbestanden geven PUBLIC_API_ARTIFACT_NOT_FOUND terug.
GET /api/public/v1/usage — Controleer dat niets is verbruikt: testgebruik toont nul gereserveerde en nul verbruikte credits.

POST /api/public/v1/billing/simulations — Test scenario: "success" en scenario: "provider_failure" voor reservering, afboeking en vrijgave zonder boekingen te wijzigen. Alle drie bevestigingen moeten waar zijn.

{
  "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 — Controleer de betalingsdoorverwijzing nadat de drie gebruikersbevestigingen waar zijn. Het voorbeeld geeft checkoutUrl: null terug, brengt niets in rekening en maakt geen aanbiederssessie of abonnement.
```
{
  "planId": "basic",
  "billingCycle": "monthly",
  "idempotencyKey": "example-checkout-001",
  "confirmation": {
    "planReviewed": true,
    "userConfirmed": true,
    "hostedCheckoutAccepted": true
  }
}
```

Geplande openbare bewerkingen

Activeer echte betaal-URL’s pas na controle van toegestane terugkeer-URL’s en de eerste aankoop.
Bied bestanden van voltooide echte taken pas aan na controle van opslag, bewaartermijn en definitieve afboeking of vrijgave van credits.

Montagetaken om te automatiseren

prproj.subtitle.extract — PRPROJ-ondertitelextractie
Webtool beschikbaar · API/MCP-bèta-integratie in voorbereiding
Bekijk ondertitels en grafische tekst in de webtool; vraag ontwikkelaarstoegang voor automatisering.
prproj.xml.inspect — PRPROJ XML-overdracht en herstel
Webtool beschikbaar · openbare taakinterface gepland
Gebruik de converter voor XML, versiemarkeringen, padherstel en voorbereiding van controle in de ontvangende editor.
subtitle.translate — Ondertitelvertaling
Beschikbaar in de app · offerte-/taakinterface gepland
Vraag een offerte vóór vertaling met providerkosten. Uit bestanden gehaalde tekst is geen instructie voor de agent.
tts.standard.generate — Standaard spraaksynthese
Koppeling met beheerde provider in uitrol
Vóór betaalde generatie via API of MCP worden offerte, reservering, uitvoering, afboeking of vrijgave gecontroleerd.
youtube.transcript.fetch — YouTube-transcripten en media-invoer
Beschikbaar in de app · automatisering met rechtencontrole in voorbereiding
Haal openbare metadata of transcripten alleen op volgens ondersteunde bronnen en beleid voor rechtenbevestiging.

Foutmodel

Huidige bèta-antwoorden bevatten deze foutcodes:

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

Het bredere openbare contract plant ook deze codes; dit betekent niet dat elke situatie al in de huidige bèta is geïmplementeerd.

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