Utwórz zadanie

bash

curl -X POST https://api.clipfoundry.pl/v1/jobs \
  -H "Authorization: Bearer cf_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: moj-klucz-123" \
  -d '{
    "script": "Miód nigdy się nie psuje. Archeolodzy znaleźli...",
    "style": "cinematic",
    "voiceId": "el_brian",
    "language": "pl",
    "durationMs": 13000
  }'

Odpowiedź (201):

json

{ "jobId": "b1a2...", "status": "pending", "progress": 0,
  "videoUrl": null, "tokensCharged": null, "createdAt": "..." }

Wywołanie wraca natychmiast — render jest asynchroniczny. Zobacz Parametry zadania i Śledzenie postępu.

Rozliczenie: naliczane po sukcesie

Tokeny są pobierane dopiero gdy zadanie się ukończy (status: done). Przy POST /v1/jobs sprawdzamy saldo i odrzucamy z insufficient_tokens, jeśli nie starcza, ale nic nie jest pobierane aż do udanego renderu. Zadania nieudane lub anulowane nie kosztują nic — brak blokady z góry i brak kroku zwrotu. tokensCharged pozostaje null, dopóki zadanie nie będzie done.